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

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