組織のポリシーを 1 件取得

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

組織の、指定した種類のポリシーを返します。この種類のポリシーが記録されていない場合、組織は環境の値を継承し、レスポンスは 404 です。

リクエスト

フィールド 型 必須 説明
org_id path はい 組織の ID(org_…)です。
policy_kind path はい ポリシーの種類: authentication_methods、mfa、phishing_resistant、sso_enforcement、session、または ip_allowlist。それ以外の値は 404 を返します。

リクエスト本文はありません。

レスポンス

200 OK とともに、ポリシーと 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
}

エラー

HTTP code 発生条件
404 not_found 組織が存在しない、種類が不明、またはこの種類のポリシーが記録されていません。
401 unauthenticated 認証情報が欠落しているか、無効か、失効しています。
403 insufficient_permissions 認証情報に必要な権限がありません。
429 rate_limited レート制限を超えました。Retry-After の期間を待ってから再試行してください。
503 service_unavailable 依存サービスが一時的に利用できません。Retry-After の期間を待ってから再試行してください。

例

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