Modify name servers

Description

Modifies the name servers of the domain

Note:

If you intend to use glue records for 'de', 'be', 'ch', 'fr', 're', 'tf', 'wf', 'yt', 'sh' or 'eu' domains, the IP addresses must be added along with your name servers. Samples are shown at the "Examples" section of this page.


Parameters

Name Data Type Status Description
auth-id or sub-auth-id or sub-auth-user Integer Required Authentication parameter
auth-password String Required Authentication parameter
domain-name String Required Name of the domain
nameservers Array Required Array with the name servers

Return: Array with status and status description


Errors

When the authentication of API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

If there is not added a domain name or if the requested domain does not exist in your account, the following status will be returned:

{"status":"Failed","statusDescription":"Missing domain-name"}

For most of the domains the minimum set for name servers is 2. If you add only 1 name server, the following status will be returned:

{"status":"Failed","statusDescription":"The minimum name servers for .com domains are 2."}

Note: These are example errors in JSON format.


 Example

URL JSON: https://api.cloudns.net/domains/set-nameservers.json
POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&nameservers[]=ns1.domain.com&nameservers[]=ns2.domain.com
POST/GET: sub-auth-id=0&auth-password=password&domain-name=domain.com&nameservers[]=ns1.domain.com&nameservers[]=ns2.domain.com

URL XML: https://api.cloudns.net/domains/set-nameservers.xml
POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&nameservers[]=ns1.domain.com&nameservers[]=ns2.domain.com
POST/GET: sub-auth-id=0&auth-password=password&domain-name=domain.com&nameservers[]=ns1.domain.com&nameservers[]=ns2.domain.com

URL JSON: https://api.cloudns.net/domains/set-nameservers.json
POST/GET: auth-id=0&auth-password=password&domain-name=domain.be&nameservers[]=ns1.domain.be 127.0.0.1&nameservers[]=ns2.domain.be 127.0.0.2
POST/GET: sub-auth-id=0&auth-password=password&domain-name=domain.be&nameservers[]=ns1.domain.be 127.0.0.1&nameservers[]=ns2.domain.be 127.0.0.2

URL XML: https://api.cloudns.net/domains/set-nameservers.xml
POST/GET: auth-id=0&auth-password=password&domain-name=domain.be&nameservers[]=ns1.domain.be 127.0.0.1&nameservers[]=ns2.domain.be 127.0.0.2
POST/GET: sub-auth-id=0&auth-password=password&domain-name=domain.be&nameservers[]=ns1.domain.be 127.0.0.1&nameservers[]=ns2.domain.be 127.0.0.2


Last modified: 2023-05-30
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more