Cancel Domain

Cancel a domain subscription at the end of the current billing period. The domain stays active until the expiry date, and auto-renew is disabled at the registrar.

Request

POST /api/v1/domains/:id/cancel

Required scope: domains:provision

Path Parameters

Parameter	Type	Description
`id`	string	The domain ID

Headers

Header	Required	Value
`Authorization`	Yes	`Bearer YOUR_API_KEY`

Response

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "example.com",
    "cancelled": true,
    "expiresAt": "2026-04-15T00:00:00.000Z"
  }
}

Response Fields

Field	Type	Description
`id`	string	The domain ID
`name`	string	The domain name
`cancelled`	boolean	Always `true` after successful cancellation
`expiresAt`	string	ISO 8601 date when the domain subscription will expire

Error Responses

Status	Code	Description
400	`NO_SUBSCRIPTION`	No active subscription found for this domain
400	`CANCEL_FAILED`	Failed to cancel the subscription
403	`INSUFFICIENT_SCOPE`	API key lacks `domains:provision` scope
404	`NOT_FOUND`	Domain not found or you do not have owner access

Example

curl -X POST https://site.quest/api/v1/domains/507f1f77bcf86cd799439011/cancel \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

Reactivation

To reactivate a cancelled domain before the expiry date, use the Reactivate Domain endpoint.

MCP

This action is also available via the cancel_domain MCP tool.