Modifying a Domain Name
Synopsis
| Description | A command for modifying a domain name. |
| URL | https://toolkit.centralnic.com/srv/modify |
| HTTP Method | POST |
| Requires Authentication? | Yes |
| Requires SSL? | Yes |
| Query Parameters: | |
| test | The test flag (eg 1 or 0, optional) |
| user | Your Registrar Handle ID |
| password | Your encrypted Registrar password |
| domain | The domain name (eg example.uk.com) |
| chandle | The new Client Contact for the domain (optional) |
| thandle | The new Technical Contact for the domain (optional) |
| url | A URL to forward the domain to (optional) |
| dns[] | DNS server changes for the domain name (optional, multiple) |
| ttl | The new Time To Live (TTL) for the domain (integer greater than 60, optional) |
This service allows for the modification of an existing domain in real-time.
The chandle parameter may be a CentralNic Handle ID to set the Client contact for the domain name.
The thandle parameter may be a CentralNic Handle ID to set the Technical Contact for the domain name.
The url paramter may be a URL to which the domain name will be forwarded. To enable this feature, any DNS servers are removed from the domain, and the dns[] parameter will be ignored. If you subsequently add nameservers to the domain, then the forwarding will stop working.
If the value of the url parameter is 'drop', then any existing URL forwarding will be removed, and the domain will be parked.
The dns[] parameter may be used as many times as needed. Each parameter must take one of the following forms:
To add a new DNS server:
dns[]=add:ns0.example.com
To add a new DNS server with IPv4 glue:
dns[]=add:ns0.example.uk.com:192.168.1.1
To add a new DNS server with IPv4 glue AND IPv6 glue:
dns[]=add:ns0.example.uk.com:192.168.1.1:2001:db8::1428:57ab
To drop an existing DNS server:
dns[]=drop:ns1.example.com
To drop all current DNS servers (does not affect any DNS servers that are being added in the same transaction):
dns[]=drop:all
The TTL parameter controls the TTL that our DNS servers supply with any resource records (NS records in the case of a delegation, or CNAME records in the case of a forwarding) for the domain. The default value is 3600 (seconds). The value of this parameter may be any integer greater than 60 (seconds).
NB: changing this value is only useful before you change the domain's DNS servers. For best results, change this value at least two TTLs before you change the DNS servers.
Response Format
Responses from the server will have the form
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 0 Message: Domain modified successfully
In the event of an error, the server will return something like this:Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 1 Message: No changes to make.