Skip to main content
POST
Delete

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
id
string

Id of the domain to delete. Accepts the bare UUID or the domain-<uuid> form (the prefix is stripped server-side).

Pattern: ^(domain-)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
purge
boolean

Hard-delete instead of soft-delete, releasing the id for reuse. Refused while the domain still has sub-domains — delete or re-parent them first.

etag
string | null

Optional optimistic-concurrency guard.

Response

200 - application/json

Success

The response is of type DeleteResponse · object.