Name icon

Name

Interact with Name API

Domain Name System → Update Record

AI-generated

Summary

Updates an existing DNS record within a specified domain zone.

Inputs

  • domainName (required) — The domain name to update records for (e.g., example.com).
  • recordId (required) — The unique ID of the record to update (must match the URI on Update).
  • answer (required) — The value for the record: IP for A/AAAA; target for ANAME, CNAME, MX, NS, or TXT; or '{weight} {port} {target}' for SRV records.
  • host (required) — The hostname relative to the zone (e.g., 'blog' for blog.example.org). Use '' or '@' for apex records. Use '{service}.{protocol}.{host}' for SRV records.
  • type (required) — The record type: A, AAAA, ANAME, CNAME, MX, NS, SRV, or TXT.
  • priority — Required for MX and SRV records; ignored for other types.
  • ttl — Time in seconds the record can be cached (minimum 300). Defaults to 300.

Output shape

A single record item containing the updated DNS record data.

The operation uses a PUT request; the response body reflects the updated record.

Examples

Example 1: Change the IP address of an existing A record

Set Type to 'A', Host to 'www', Answer to '192.0.2.1', and provide the domainName and recordId.

Example 2: Update the destination of a CNAME record

Set Type to 'CNAME', Host to 'mail', Answer to 'mail.example.com', and provide the domainName and recordId.

Links

Discussion