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
| Status | When |
|---|---|
401 | Invalid or expired session token |
403 | Caller does not have admin or owner role, or domain belongs to a different tenant |
404 | Domain ID does not exist |