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

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