Replace a DNS record

Full description

Fully replaces an existing DNS record identified by recordId. All writable fields (name, type, data, ttl) must be supplied; partial updates are not supported. Changes are applied synchronously. GoDaddy-managed records (SOA, NS) are read-only and return 409 when targeted.

Authorization

bearerAuth

AuthorizationBearer <token>

Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.

In: header

Path Parameters

zone*string

The domain name in punycode A-label form (for example, example.com). For IDNs, use the punycode representation.

recordId*string

Server-assigned DNS record identifier within the zone.

Header Parameters

X-Request-Id?string

Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.

Formatuuid

Request Body

application/json

A single DNS resource record within a zone.

name*string

The DNS record name relative to the zone apex. Use @ to represent the zone apex itself (e.g. the bare domain example.com).

Length1 <= length <= 255

type*DNS Record Type

Value in

"A"
"AAAA"
"CNAME"
"MX"
"TXT"
"NS"
"SRV"
"SOA"
"CAA"

data*string

The record value. Format is type-specific — for example, an IPv4 address for A records, or a hostname for CNAME and MX records.

Length1 <= length <= 512

ttl*integer

Time-to-live in seconds. Controls how long resolvers cache this record.

Range600 <= value <= 86400

priority?integer

Priority value for MX and SRV records. Lower values are preferred.

Range0 <= value <= 65535

service?string

Service label for SRV records (e.g. _http).

port?integer

Port number for SRV records.

Range0 <= value <= 65535

weight?integer

Weight for SRV load balancing among records with equal priority. Higher weight increases the probability of selection.

Range0 <= value <= 65535

protocol?string

Protocol identifier for SRV records (e.g. _tcp, _udp).

flag?integer

Flag byte for CAA records. 0 indicates non-critical; 128 indicates critical (the issuer must understand the tag property to proceed).

Range0 <= value <= 255

tag?string

Tag property for CAA records. Common values: issue, issuewild, iodef.

Response Body

`application/json`

curl -X PUT "https://example.com/zones/example.com/dns-records/Aad7oqdXCms9mlJvm_m6UFYqmwjyP20H2KBmQHgttK9kGbF_TuI3knsocArQqIv5I0Kq5C0" \  -H "Content-Type: application/json" \  -d '{    "name": "@",    "type": "A",    "data": "192.0.2.1",    "ttl": 3600  }'

{  "recordId": "string",  "name": "string",  "type": "A",  "data": "string",  "ttl": 600,  "priority": 0,  "service": "string",  "port": 0,  "weight": 0,  "protocol": "string",  "flag": 0,  "tag": "string"}

Agent & Automation Notes

Scopesdomains.domain:read, domains.domain:create, domains.dns:update, domains.nameserver:update

Rate limit60 req/min per credential

On failureGET operations are safe to retry. POST registrations use Idempotency-Key. Poll async operations — do not resubmit.

Guides

Concepts

Last updated on

Replace a DNS record

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

409application/json

422application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`