API reference

Delete a sending domain

Permanently removes a sending domain and its DKIM keypair. Cannot be undone. Required role: admin or owner.

DELETE/v1/admin/sending-domains/:id

IRREVERSIBLE

Deleting a sending domain permanently destroys the DKIM private key. Emails signed with the old key will no longer validate. If you need to use the same domain again, add it fresh — a new keypair will be generated and you will need to update the DKIM DNS record.

Request

curl
curl -X DELETE https://api-raven-cloud.autotribes.app/v1/admin/sending-domains/9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e \
  -H "Authorization: Bearer eyJ..." \
  -H "X-App-Name: raven-cloud" \
  -H "X-Tenant-Slug: acme-co"

Response

204 No Content

Empty body on success.

Errors

StatusWhen
401Invalid or expired session token
403Caller does not have admin or owner role, or domain belongs to a different tenant
404Domain ID does not exist