Manage the nameservers on a domain: read the current set, replace it, and register, modify, or delete child (glue) nameservers hosted under the domain.

Get nameservers

Return the nameservers currently set on a domain. GET /domains/{domain}/nameservers

Parameters

text
required
The domain to read, for example example.com.

Request

Response

Save nameservers

Replace the nameservers on a domain. Provide at least ns1 and ns2; ns3 through ns5 are optional. POST /domains/{domain}/nameservers

Parameters

text
required
The domain to update, for example example.com.
text
required
Primary nameserver hostname.
text
required
Secondary nameserver hostname.
text
Third nameserver hostname.
text
Fourth nameserver hostname.
text
Fifth nameserver hostname.

Request

The Go and Node.js save snippets reuse the token() helper and imports from the get example. Go also needs net/url and strings.

Response

boolean
true when the nameservers are saved.

Register a child nameserver

Register a child (glue) nameserver hosted under this domain, for example ns1.example.com, and point it at an IP address. POST /domains/{domain}/nameservers/register

Parameters

text
required
The parent domain, for example example.com.
text
required
The child nameserver hostname to register, for example ns1.example.com.
text
required
The IP address the nameserver resolves to.

Request

Modify a child nameserver

Change the IP address of an existing child nameserver. POST /domains/{domain}/nameservers/modify

Parameters

text
required
The parent domain, for example example.com.
text
required
The child nameserver hostname to modify, for example ns1.example.com.
text
required
The IP address currently assigned to the nameserver.
text
required
The new IP address to assign.

Request

Delete a child nameserver

Remove an existing child nameserver from the domain. POST /domains/{domain}/nameservers/delete

Parameters

text
required
The parent domain, for example example.com.
text
required
The child nameserver hostname to delete, for example ns1.example.com.

Request

Child nameserver registration, modification, and deletion depend on the registrar module backing your account. On registrars that do not support glue records, these calls return a 501 “Function not supported by the registrar module”.