Skip to main content
DELETE
/
v1
/
domains
/
{id}
Delete Domain
curl --request DELETE \
  --url https://api.example.com/v1/domains/{id}

Delete Domain

Remove a domain from your account.
id
string
required
The ID of the domain to delete.

Request

curl -X DELETE https://api.lettr.dev/v1/domains/dom_123abc \
  -H "Authorization: Bearer le_xxxxxxxxxxxx"

Response

{
  "id": "dom_123abc",
  "object": "domain",
  "deleted": true
}
Deleting a domain is permanent. You will no longer be able to send emails from addresses on this domain.

Errors

CodeDescription
not_foundDomain with specified ID not found
in_useDomain has pending emails and cannot be deleted