Delete
Delete a domain. Idempotent — deleting an already-deleted or unknown domain
succeeds. Soft-deletes by default; set purge to hard-delete and release the
id, which is refused while the domain still has sub-domains. Pass etag to
guard against deleting a concurrently-edited domain.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Id of the domain to delete. Accepts the bare UUID or the domain-<uuid> form
(the prefix is stripped server-side).
^(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}$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.
Optional optimistic-concurrency guard.
Response
Success
The response is of type DeleteResponse · object.