Skip to main content
Use this endpoint to replace the nameservers for a domain in your workspace. The operation performs a full replacement — the list you provide becomes the complete set of nameservers for the domain, and any previously configured nameservers are removed. This is how you point a domain at your own DNS infrastructure or a third-party DNS provider.

​
Request

Method: PATCH
Path: /v1/domains/{domain}/nameservers

​
Path Parameters

​
string
required
The domain name whose nameservers you want to update (e.g. example.com).

​
Body Parameters

​
string[]
required
An array of 2 to 13 fully-qualified nameserver hostnames (e.g. ["ns1.example.com", "ns2.example.com"]). Each entry must be a valid hostname string. The order of the array is preserved.
If the domain hasn’t been fully provisioned yet (for example, it was registered very recently and is still propagating), the nameserver changes are saved immediately and will be applied automatically once provisioning completes. The pendingFulfillment: true flag in the response indicates this state.

​
Request Example

​
Response — 200 OK

​
string[]
The updated list of nameserver hostnames now assigned to the domain, in the order they were provided.
​
boolean
true if the domain is still being provisioned and the nameserver change will be applied automatically once the registration completes. false if the change was applied immediately.

​
Errors