
# メール送信元ドメインを削除

`DELETE /v1/email-sender-domains/{sender_domain_id}` · 権限 `email-sender-domains:write` · すべてのプラン

送信元ドメインを削除します。メール配信設定がまだ使用しているドメインは削除できません。先に[メールプロバイダー](../email-provider/put.md)を別のモードに切り替えてください。削除後に、ドメインの DNS レコードを削除できます。

## リクエスト

| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| `sender_domain_id` | string | はい | 送信元ドメイン ID（`sdom_…`）。 |
| `If-Match` | ヘッダー | はい | ドメインの `ETag`。`*` は任意のバージョンに一致します。ない場合は `428`、一致しない場合は `412`。 |

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

## レスポンス

`204 No Content`。

## エラー

| HTTP | code | 発生条件 |
|---|---|---|
| 404 | `not_found` | 送信元ドメインが存在しない、別の環境に属している、または ID の形式が不正。 |
| 409 | `conflict` | メール配信設定がそのドメインを使用している（`platform_managed_domain`）。先に[メールプロバイダー](../email-provider/put.md)を別のモードまたはドメインに切り替えてください。 |
| 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` の時間が経過してから再試行してください。 |

## 例

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/email-sender-domains/sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'
```

CLI: `keenauth email-sender-domains delete sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 --if-match '"2"'`
