Org politikasını getir

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

Org'un bir türdeki politikasını döndürür. Bu türde politika yazılmamışsa org ortamın değerini devralır ve yanıt 404'tür.

İstek

Alan Tür Zorunlu Açıklama
org_id path evet Org kimliği (org_…).
policy_kind path evet Politika türü: authentication_methods, mfa, phishing_resistant, sso_enforcement, session ya da ip_allowlist. Başka değer 404 döner.

İstek gövdesi yoktur.

Yanıt

Politikayla ve ETag başlığıyla 200 OK.

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

Hatalar

HTTP code Ne zaman
404 not_found Org yok, tür bilinmiyor ya da bu türde politika yazılmamış.
401 unauthenticated Kimlik bilgisi yok, geçersiz ya da iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinde gerekli izin yok.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

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