Skip to content

Delete a domain

DELETE
/api/organizations/{organizationId}/domains/{id}

Deletes a domain together with its managed DNS zone and every DNS record in that zone, freeing the domain name for use again. Rejected with 409 when the domain is shared (shared domains are managed centrally), when hostnames still belong to it (delete those hostnames, and the zones or redirects that own them, first), when it still has a certificate (delete the certificate first), or when the domain's nameservers still point to the managed DNS service - repoint the domain at your registrar first, otherwise deleting the zone would take the domain offline. Returns 503 when the nameserver lookup cannot be performed, so a domain is never deleted while its delegation state is unknown.

Authorizations

ApiToken

Long-lived API token created via POST /api/api-tokens (returned once in plaintext). A token created with readOnly may only perform safe requests (GET, HEAD, OPTIONS); write requests are rejected on every endpoint.

Type
API Key (header: X-API-TOKEN)
or
JWT

JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer .

Type
HTTP (bearer)

Parameters

Path Parameters

organizationId*

Organization identifier

Type
string
Required
id*

domain identifier

Type
string
Required

Responses

domain resource deleted

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI