Cancel a pending domain verification

cancel_domain_verification

Abandons the domain a site is waiting to verify, deleting the pending domain and its verification token.

POST /v1/cancel_domain_verificationScopeconfig:writeDestructive

To try again later you have to start over with start_domain_verification and add a fresh TXT record. None of the site's custom domains is touched. It needs the Manage domains permission in the workspace. See A domain waiting on verification.

Request

Call it with a POST to https://api.modulify.ai/v1/cancel_domain_verification, sending the inputs below as a JSON object. The token needs the config:write scope.

This method is marked destructive: it deletes or overwrites data. Check the inputs before you call it, and send an Idempotency-Key header whenever you might retry it.

curl -X POST https://api.modulify.ai/v1/cancel_domain_verification \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"PROJECT_ID","workspaceId":"WORKSPACE_ID"}'

Over MCP, the same method is the cancel_domain_verification tool.

Inputs

Input	Type	Required	Description
`projectId`	string	Yes	The site id.
`workspaceId`	string	Yes	The workspace the site belongs to.

Response

Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.