E-Mail-Absenderdomain löschen
DELETE /v1/email-sender-domains/{sender_domain_id} · Berechtigung email-sender-domains:write · alle Tarife
Löscht eine Absenderdomain. Eine Domain, die die E-Mail-Zustellkonfiguration noch verwendet, kann nicht gelöscht werden: Stellen Sie den E-Mail-Anbieter zuerst auf einen anderen Modus um. Nach dem Löschen können Sie die DNS-Einträge der Domain entfernen.
Anfrage
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
sender_domain_id |
string | ja | ID der Absenderdomain (sdom_…). |
If-Match |
Header | ja | Der ETag der Domain; * passt auf jede Version. 428, wenn er fehlt, 412, wenn er nicht passt. |
Kein Request-Body.
Antwort
204 No Content.
Fehler
| HTTP | code | Wann |
|---|---|---|
| 404 | not_found |
Die Absenderdomain existiert nicht, gehört zu einer anderen Umgebung oder die ID ist fehlerhaft. |
| 409 | conflict |
Die E-Mail-Zustellkonfiguration verwendet die Domain (platform_managed_domain). Stellen Sie den E-Mail-Anbieter zuerst auf einen anderen Modus oder eine andere Domain um. |
| 412 | precondition_failed |
If-Match passt nicht zur aktuellen Version der Domain. |
| 428 | precondition_required |
If-Match fehlt. |
| 401 | unauthenticated |
Das Zugangsdatum fehlt, ist ungültig oder widerrufen. |
| 403 | insufficient_permissions |
Das Zugangsdatum hat nicht die erforderliche Berechtigung. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Zeit aus Retry-After. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach der Zeit aus Retry-After. |
Beispiel
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"'