# 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](../email-provider/put.md) 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](../email-provider/put.md) 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

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