Skip to main content
Use this endpoint to modify one or more fields on an existing DNS record. The update is partial — only the fields you include in the request body are changed, and all other fields retain their current values. This makes it safe to, for example, update just the value of an A record without affecting its ttl or name. You’ll need the opaque id returned when the record was created or listed.

​
Endpoint

PATCH /v1/domains/{domain}/dns/{recordId}

​
Path Parameters

​
string
required
The domain name the record belongs to (e.g. example.com).
​
string
required
The opaque record identifier returned by the list or create endpoints.

​
Body Parameters

All body fields are optional. At least one must be provided.
​
string
The new record type. Must be one of: A, AAAA, ALIAS, CNAME, HTTPS, MX, NS, PTR, SRV, SVCB, TLS, TXT.
​
string
The new record name. Use @ for the domain apex.
​
integer
The new time to live in seconds. Values are clamped to the range 60–86400.
​
string
The new record value.

​
Request Example

​
Response

200 OK The full updated record object is returned.
​
object
The DNS record after applying the requested changes.

​
Errors