# カスタムドメインを削除

`DELETE /v1/custom-domains/{custom_domain_id}` · 権限 `custom-domains:write`

カスタムドメインを削除します。ドメインは `released` 状態になり、そのドメインでのサインインは停止し、名前は 30 日間隔離されます（他の環境は追加できません）。プライマリドメインと、環境の発行者として使われているドメインは削除できません。先に別のドメインをプライマリに設定してください。すでに解放されたドメインを削除しても、プラットフォームのレジストリでの解放が繰り返されるだけです。

## リクエスト

| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| `custom_domain_id` | string | はい | カスタムドメインの ID（`cdom_…`）。 |
| `If-Match` | header | はい | 必須。ドメインの `ETag`。欠落時は `428`、一致しない場合は `412`。 |

リクエストボディはありません。

## レスポンス

`204 No Content`。

## エラー

| HTTP | code | 発生条件 |
|---|---|---|
| 404 | `not_found` | カスタムドメインが存在しないか、別の環境に属しています。 |
| 409 | `custom_domain_in_use` | そのドメインはプライマリドメインか、環境の発行者です。 |
| 409 | `domain_in_use_by_rp_id` | そのドメインは、ある接続のパスキー rpId か、実行中の rpId 移行の旧 rpId です。先に [パスキーの rpId を変更](../connections/change-rp-id.md)で rpId を移動してください。 |
| 412 | `precondition_failed` | `If-Match` がドメインの現在のバージョンと一致しません。 |
| 428 | `precondition_required` | `If-Match` がありません。 |
| 503 | `service_unavailable` | プラットフォームのドメインレジストリ、または環境の発行者情報が一時的に利用できません。 |
| 401 | `unauthenticated` | 認証情報がないか、無効または取り消されています。 |
| 403 | `insufficient_permissions` | 認証情報に必要な権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間を過ぎてから再試行してください。 |

## 例

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/custom-domains/cdom_01j9xk3m7q8r2s4t6v8w0y2z4a \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "3"'
```