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.
| 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 |
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.
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