Delete a DNS record of a bought domain

delete_dns_record

Deletes one DNS record of a domain the workspace bought, chosen by its Id from list_dns_records.

POST /v1/delete_dns_recordScopedomains:writeDestructive

Sites, email or services that rely on the record can stop working once DNS servers drop their cached copy, so the tool tells the client to confirm with you first. A record that is already gone answers The DNS record was already deleted. A record with Locked true is refused, because Modulify manages it, and the refusal says what releases it.

It needs the Manage domains permission, and the domain must be active or expiring. The workspace can make 30 domain changes a minute, shared with the Domains page and covering DNS records, nameservers, the registrant, the transfer lock, auto-renew and transfer codes, and a refusal says how long to wait. See Edit or delete a record.

Request

Call it with a POST to https://api.modulify.ai/v1/delete_dns_record, sending the inputs below as a JSON object. The token needs the domains: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/delete_dns_record \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"WORKSPACE_ID","domainId":"DOMAIN_ID","recordId":1}'

Over MCP, the same method is the delete_dns_record tool.

Inputs

Input Type Required Description
workspaceId string Yes The workspace that owns the domain.
domainId string Yes The _id of the bought domain, from list_bought_domains.
recordId integer Yes The Id of the record, from list_dns_records.

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.