Patch DNS record
patch_dns_recordUpdate selected fields of an existing DNS record and keep all unspecified values unchanged.
Instructions
Change only some fields of an existing DNS record, e.g. just data or ttl. The current record is read first and every field you leave out keeps its stored value; when you change the type, give the new type's required fields too. Prefer this over update_dns_record. Returns the stored record.
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_id": "<domain_id>",
"record_id": "<record_id>"
},
"name": "patch_dns_record"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alg | No | required for DS: the DNSSEC signing algorithm number, 0-255 | |
| tag | No | required for DS as a number (the key tag 0-65535 of the referenced DNSKEY) and for CAA as a string (the property tag, e.g. issue, issuewild or iodef) | |
| ttl | No | time-to-live in seconds, 60-604800, must be a multiple of 60, defaults to 3600 | |
| data | No | the record's main value: an IPv4 address for A, an IPv6 address for AAAA, a hostname for ANAME/CNAME/MX/NS/SRV, free text for TXT, the CAA property value, or the hex hash for DS/TLSA | |
| host | No | the host/subdomain the record applies to, e.g. 'www' or '@' for the root | |
| port | No | required for SRV: the port 0-65535 the service is found on | |
| type | No | the record type | |
| dtype | No | required for TLSA: matching type of the hash in data (0 exact match, 1 SHA-256, 2 SHA-512) | |
| flags | No | required for CAA: 128 to mark the property critical, otherwise 0 | |
| usage | No | required for TLSA: certificate usage (0 PKIX-TA, 1 PKIX-EE, 2 DANE-TA, 3 DANE-EE) | |
| digest | No | required for DS: digest type of the hash in data (1 SHA-1, 2 SHA-256, 4 SHA-384) | |
| weight | No | required for SRV: relative weight 0-65535 among records with the same priority | |
| priority | No | required for MX and SRV: preference value 0-65535, lower is tried first | |
| selector | No | required for TLSA: what the hash is taken from (0 full certificate, 1 subject public key) | |
| domain_id | Yes | the Domeneshop domain ID, from list_domains | |
| record_id | Yes | the DNS record ID to change, from list_dns_records |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| alg | No | ||
| tag | No | ||
| ttl | No | ||
| data | Yes | ||
| host | Yes | ||
| port | No | ||
| type | Yes | ||
| dtype | No | ||
| flags | No | ||
| usage | No | ||
| digest | No | ||
| weight | No | ||
| priority | No | ||
| selector | No |