Delete a domain

Remove a domain and tear down its DKIM identity. Allowed only when the domain has never been used to send — history is kept immutable. DELETE /v1/domains/{id} Deleting a domain removes it from the project and, when no sibling project still uses the same domain name, releases the underlying sending identity. This is the path to take when you mistyped a domain and want to re-add it cleanly.

Path parameters

string

required

The domain id to delete, for example dom_01HZ8K3M9P.

Request

curl -X DELETE https://api.drin.run/v1/domains/dom_01HZ8K3M9P \
  -H "Authorization: Bearer $DRIN_API_KEY"

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

await drin.domains.delete("dom_01HZ8K3M9P");

Response

204 No Content on success — there is no response body.

409 on sending history. A domain that has ever sent mail cannot be deleted — the request is refused with 409 Conflict so the audit trail stays intact. Disable receiving or stop sending from it instead.

{
  "error": {
    "type": "conflict",
    "message": "Domain has sending history and cannot be deleted."
  }
}

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

Delete a domain

Path parameters

Request

Response

​Path parameters

​Request

​Response

Path parameters

Request

Response