Eine Richtlinie einer Organisation abrufen

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

Gibt die Richtlinie der Organisation einer bestimmten Art zurück. Ist keine Richtlinie dieser Art geschrieben, erbt die Organisation den Wert der Umgebung und die Antwort ist 404.

Anfrage

Feld	Typ	Pflicht	Beschreibung
`org_id`	path	ja	ID der Organisation (`org_…`).
`policy_kind`	path	ja	Art der Richtlinie: `authentication_methods`, `mfa`, `phishing_resistant`, `sso_enforcement`, `session` oder `ip_allowlist`. Jeder andere Wert ergibt `404`.

Kein Anfragetext.

Antwort

200 OK mit der Richtlinie und einem ETag-Header.

{
  "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
}

Fehler

HTTP	code	Wann
404	`not_found`	Die Organisation existiert nicht, die Art ist unbekannt oder es ist keine Richtlinie dieser Art geschrieben.
401	`unauthenticated`	Der Berechtigungsnachweis fehlt, ist ungültig oder widerrufen.
403	`insufficient_permissions`	Dem Berechtigungsnachweis fehlt die erforderliche Berechtigung.
429	`rate_limited`	Das Ratenlimit wurde überschritten; wiederholen Sie nach dem Zeitraum aus `Retry-After`.
503	`service_unavailable`	Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie nach dem Zeitraum aus `Retry-After`.

Beispiel

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