Delete Domain
DELETE /v1/domain/{id}
/v1/domain/{id}{id}Delete an active domain (soft-delete, reversible via revoke)
Mark an active domain as deleted. The domain's status is moved from "active" to "deleted" and its mailboxes are taken out of sending rotation.
Preconditions: The domain must currently be in status: "active". Calling delete on a domain that is inProgress, already deleted, failed, or expired is rejected.
AnnualFlexi behaviour: When the parent order is on the annualFlexi plan, deleting the domain reserves a slot tied to the order so a replacement domain can be swapped in later for the remaining term. Other plan types do not create a reserved slot.
Reversible: A deleted domain can be restored via POST /v1/domain/{id}/revoke as long as it is still in status: "deleted". Final hard-removal from the registrar is performed asynchronously by an internal cron after deletion.
This endpoint operates on a single domain id at a time — use the domain's id from GET /v1/domain, not the orderId.
Authorization
x-api-key<token>
API key for Open API authentication
In: header
Path Parameters
idstring
Hashid-encoded domain ID from GET /v1/domain.