Supprimer un domaine d'expédition d'e-mail

DELETE /v1/email-sender-domains/{sender_domain_id} · permission email-sender-domains:write · tous les forfaits

Supprime un domaine d'expédition. Un domaine encore utilisé par la configuration de distribution des e-mails ne peut pas être supprimé : commencez par faire passer le fournisseur d'e-mail dans un autre mode. Après la suppression, vous pouvez retirer les enregistrements DNS du domaine.

Requête

Champ Type Obligatoire Description
sender_domain_id string oui Identifiant du domaine d'expédition (sdom_…).
If-Match en-tête oui L'ETag du domaine ; * correspond à toute version. 428 s'il est absent, 412 s'il ne correspond pas.

Aucun corps de requête.

Réponse

204 No Content.

Erreurs

HTTP code Quand
404 not_found Le domaine d'expédition n'existe pas, appartient à un autre environnement ou l'identifiant est mal formé.
409 conflict La configuration de distribution des e-mails utilise le domaine (platform_managed_domain). Faites d'abord passer le fournisseur d'e-mail dans un autre mode ou vers un autre domaine.
412 precondition_failed If-Match ne correspond pas à la version actuelle du domaine.
428 precondition_required If-Match est absent.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant n'a pas la permission requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la durée indiquée par Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la durée indiquée par Retry-After.

Exemple

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"'