組織のポリシーを 1 件削除

DELETE /v1/organizations/{org_id}/policies/{policy_kind} · 権限 organizations:write

ポリシーを削除すると、組織はこの種類について環境の値に戻ります。削除内容は管理監査ログに書き込まれ、organization.updated イベントが発行されます。

リクエスト

フィールド 型 必須 説明
org_id path はい 組織の ID(org_…)です。
policy_kind path はい ポリシーの種類: authentication_methods、mfa、phishing_resistant、sso_enforcement、session、または ip_allowlist。それ以外の値は 404 を返します。
If-Match ヘッダー はい 必須です。直前に読み取った ETag("<version>")。

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

レスポンス

204 No Content。

エラー

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

例

curl -X DELETE https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/policies/mfa \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "1"'