Obtenir une politique d'organisation

GET /v1/organizations/{org_id}/policies/{policy_kind} · autorisation organizations:read

Renvoie la politique de l'organisation d'un type donné. Si aucune politique de ce type n'est écrite, l'organisation hérite de la valeur de l'environnement et la réponse est 404.

Requête

Champ Type Obligatoire Description
org_id path oui Identifiant de l'organisation (org_…).
policy_kind path oui Type de politique : authentication_methods, mfa, phishing_resistant, sso_enforcement, session ou ip_allowlist. Toute autre valeur renvoie 404.

Aucun corps de requête.

Réponse

200 OK avec la politique et un en-tête ETag.

{
  "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "policy_kind": "mfa",
  "schema_version": 1,
  "settings": {
    "required_for": "all",
    "allowed_factors": [
      "totp",
      "webauthn"
    ],
    "enrollment_grace_days": 7
  },
  "updated_at": "2026-10-12T09:30:00.123456Z",
  "version": 1
}

Erreurs

HTTP code Quand
404 not_found L'organisation n'existe pas, le type est inconnu, ou aucune politique de ce type n'est écrite.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la période Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la période Retry-After.

Exemple

curl https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/policies/mfa \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"