Delete a DNS record
domainRecordDeleteDelete ONE of the owner’s DNS records from a domain Tofu registered for them — Delete under Your domains → DNS records. Requires confirmed: true, representing the human’s agreement to delete this exact record; without the literal nothing is sent. The input identifies the record by id, host, type and answer: it is then deleted only while it is still that one (changed otherwise). This tool deletes A, AAAA, CNAME and SRV records only — never MX or TXT (dashboard_only: the human deletes those on the Domains page) — and never one Tofu keeps for the site (tofu_record). Tofu keeps a copy of the zone first (snapshotId), which the dashboard’s Restore puts back. message says what happened: a refusal changes nothing and says why; a record already gone answers absent, so repeating is safe; an unsure answer means the record may or may not be gone and says what to do before deleting it again.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain": "<domain>",
"record": "<record>",
"confirmed": "<confirmed>"
},
"name": "domainRecordDelete"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | ||
| record | Yes | ||
| confirmed | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | ||
| message | Yes | ||
| outcome | Yes | ||
| snapshotId | Yes |