NetBird Full API Reference + Read-Only MCP Prototype
PUT/api/dns/zones/{zoneId}/records/{recordId}

Replace a DNS record

Replaces a DNS record in a specific zone. Supply name, type, content, and ttl with the record's updated values; the record name must match the zone's domain or be a subdomain within it.

2 parameters · 4 body fields
zoneIdstringrequired
The unique identifier of the zone containing the DNS record.
recordIdstringrequired
The unique identifier of the DNS record to replace.

DNS record details. name, type, content, and ttl are required.

contentstringrequired
DNS record content (IP address for A/AAAA, domain for CNAME)
namestringrequired
FQDN for the DNS record. Must be a subdomain within or match the zone's domain.
ttlintegerrequired
Time to live in seconds
typestringrequired
DNS record type
Allowed:AAAAACNAME

6 status codes
200Returns the updated DNS record object, including its identifier, name, type, content, and TTL.
idstringrequired
DNS record ID
contentstringrequired
DNS record content (IP address for A/AAAA, domain for CNAME)
namestringrequired
FQDN for the DNS record. Must be a subdomain within or match the zone's domain.
ttlintegerrequired
Time to live in seconds
typestringrequired
DNS record type
Allowed:AAAAACNAME
400Returned when the request is invalid, including when required fields are missing or a field value violates a schema constraint.
401Returned when authentication is required but missing or invalid.
403Returned when access to the DNS record is forbidden.
404Returned when the zone or DNS record cannot be found.
500Returned when an internal server error occurs.

Error handling

A 400 indicates an invalid request; a 401 means authentication is required; a 403 indicates access is forbidden. A 404 is returned when either the zoneId path parameter or the recordId path parameter does not identify an available resource, and a 500 indicates an internal server error. The body must include name, type, content, and ttl; type must be A, AAAA, or CNAME, content must be 1 to 255 characters, and ttl must be at least 0.