Delete an email sender domain

DELETE /v1/email-sender-domains/{sender_domain_id} · permission email-sender-domains:write · all plans

Deletes a sender domain. A domain the email delivery configuration still uses cannot be deleted: first switch the email provider to another mode. After deletion you can remove the domain's DNS records.

Request

Field	Type	Required	Description
`sender_domain_id`	string	yes	Sender domain ID (`sdom_…`).
`If-Match`	header	yes	The domain's `ETag`; `*` matches any version. `428` when missing, `412` when it does not match.

No request body.

Response

204 No Content.

Errors

HTTP	code	When
404	`not_found`	The sender domain does not exist, belongs to another environment or the ID is malformed.
409	`conflict`	The email delivery configuration uses the domain (`platform_managed_domain`). Switch the email provider to another mode or domain first.
412	`precondition_failed`	`If-Match` does not match the domain's current version.
428	`precondition_required`	`If-Match` is missing.
401	`unauthenticated`	The credential is missing, invalid or revoked.
403	`insufficient_permissions`	The credential lacks the required permission.
429	`rate_limited`	The rate limit was exceeded; retry after the `Retry-After` period.
503	`service_unavailable`	A dependency is temporarily unavailable; retry after the `Retry-After` period.

Example

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