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

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

送信元ドメインを削除します。メール配信設定がまだ使用しているドメインは削除できません。先にメールプロバイダーを別のモードに切り替えてください。削除後に、ドメインの 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）。先にメールプロバイダーを別のモードまたはドメインに切り替えてください。
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/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"'