
# Elimina un dominio mittente e-mail

`DELETE /v1/email-sender-domains/{sender_domain_id}` · permesso `email-sender-domains:write` · tutti i piani

Elimina un dominio mittente. Un dominio che la configurazione di consegna e-mail sta ancora usando non può essere eliminato: prima cambiate il [provider di posta elettronica](../email-provider/put.md) in un'altra modalità. Dopo l'eliminazione potete rimuovere i record DNS del dominio.

## Richiesta

| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `sender_domain_id` | string | sì | ID del dominio mittente (`sdom_…`). |
| `If-Match` | intestazione | sì | L'`ETag` del dominio; `*` corrisponde a qualsiasi versione. `428` se manca, `412` se non corrisponde. |

Nessun corpo della richiesta.

## Risposta

`204 No Content`.

## Errori

| HTTP | code | Quando |
|---|---|---|
| 404 | `not_found` | Il dominio mittente non esiste, appartiene a un altro ambiente o l'ID è malformato. |
| 409 | `conflict` | La configurazione di consegna e-mail usa il dominio (`platform_managed_domain`). Prima cambiate [il provider di posta elettronica](../email-provider/put.md) in un'altra modalità o dominio. |
| 412 | `precondition_failed` | `If-Match` non corrisponde alla versione corrente del dominio. |
| 428 | `precondition_required` | `If-Match` manca. |
| 401 | `unauthenticated` | La credenziale è mancante, non valida o revocata. |
| 403 | `insufficient_permissions` | La credenziale non ha il permesso richiesto. |
| 429 | `rate_limited` | È stato superato il limite di frequenza; riprovate dopo il periodo indicato da `Retry-After`. |
| 503 | `service_unavailable` | Una dipendenza è temporaneamente non disponibile; riprovate dopo il periodo indicato da `Retry-After`. |

## Esempio

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