Update Record

Replaces an existing DNS record with new data. This is a full overwrite — all required fields (host, type, answer, ttl) must be included in the request body. If you omit a field, the existing value will not be preserved and the request may fail. Use GetRecord beforehand to retrieve the current values if you intend to modify just one field. The record ID must belong to a domain you manage.

domainNamestring required

DomainName is the zone that the record belongs to.

idinteger required

Unique record id. Value is ignored on Create, and must match the URI on Update.

Request body

answerstring required

Answer is either the IP address for A or AAAA records; the target for ANAME, CNAME, MX, or NS records; the text for TXT records. For SRV records, answer has the following format: "{weight} {port} {target}" e.g. "1 5061 sip.example.org".

fqdnstring

FQDN is the Fully Qualified Domain Name. It is the combination of the host and the domain name. It always ends in a ".". FQDN is ignored in CreateRecord, specify via the Host field instead.

hoststring

Host is the hostname relative to the zone: e.g. for a record for blog.example.org, domain would be "example.org" and host would be "blog". An apex record would be specified by either an empty host "" or "@". A SRV record would be specified by "{service}.{protocol}.{host}": e.g. "_sip._tcp.phone" for _sip._tcp.phone.example.org.

priorityinteger

Priority is only required for MX and SRV records, it is ignored for all others.

ttlinteger

TTL is the time this record can be cached for in seconds. name.com allows a minimum TTL of 300, or 5 minutes.

Type is one of the following: A, AAAA, ANAME, CNAME, MX, NS, SRV, or TXT.

Response

A successful response.

answerstring

Answer is either the IP address for A or AAAA records; the target for ANAME, CNAME, MX, or NS records; the text for TXT records. For SRV records, answer has the following format: "{weight} {port} {target}" e.g. "1 5061 sip.example.org".

domainNamestring