組織のドメインを削除
DELETE /v1/organization-domains/{domain_id} · 権限 organization-domains:write
ドメインを完全に削除します。ドメインのキャプチャ設定と SSO ルーティング設定も一緒に削除されます。削除内容は管理監査ログに書き込まれ、organization_domain.deleted イベントが発行されます。
リクエスト
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
domain_id |
path | はい | 組織ドメインの ID(odm_…)です。 |
If-Match |
ヘッダー | いいえ | 任意です。送信する場合、直前に読み取った ETag("<version>")と一致する必要があります。 |
リクエスト本文はありません。
レスポンス
204 No Content。
エラー
| HTTP | code | 発生条件 |
|---|---|---|
| 404 | not_found |
この環境に、このIDの組織ドメインは存在しません。 |
| 412 | precondition_failed |
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/organization-domains/odm_01j9xk3m7q8r2s4t6v8w0y2z4c \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"