Modifying a Handle
Synopsis
| Description: | A command to modify a handle object |
| URL: | https://toolkit.centralnic.com/srv/modify_handle |
| 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 |
| handle | The ID of the handle to be modified |
| name | The new name for the handle (optional) |
| company | The new company/organisation for the handle (optional) |
| street1 | The new street address for the handle (optional) |
| street2 | The new street address for the handle (optional) |
| street3 | The new street address for the handle (optional) |
| city | The new city for the handle (optional) |
| sp | The new state/province for the handle (optional) |
| postcode | The new postcode for the handle (optional) |
| country | The new country for the handle (optional) |
| phone | The new phone number for the handle (optional) |
| fax | The new fax number for the handle (optional) |
| The new email for the handle (optional) | |
| visible | Whether to show the handle in WHOIS records (1 or 0, optional) |
This function allows you to update the contact details of any Handle for which you are the "sponsor". You will be the "sponsor" for any handle that is created through the create_handle, register or modify functions. You will also probably be the sponsor for any handle that is the Client handle for a domain on your account (the exception is when that handle is also associated with domain names on another registrar's account, in that situation neither registrar has sponsorship).
Please note that this function must not be used merely to change the client contact for a domain name to an entirely new entity, but only for incremental corrections to contact details. Also, changing the contact name or company for a handle will not affect the Registrant field for a domain name.
NB: You do not need to specify all the contact details if you only wish to change a subset of them.
- handle must be the unique ID assigned to each handle.
- name, company, street1, street2, street3, city, sp and postcode must all be plain text strings.
- country must be a two-character ISO-3166 country code, (UK is allowed in place of GB).
-
phone and fax should be formatted in an e164a-compliant format, eg:
+44.8700170900
- email must be a valid e-mail address.
- visible is a binary value that controls whether the handle's contact details are show in WHOIS records for domain names to which it is associated. A value of 0 makes the handle "invisible".
Legacy Parameters
Prior to September 2006 this function accepted an address parameter for old-style flat address data. While this parameter is still supported, its use is not recommended in new client code.
Response Format
Responses from the server will have the form
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 0 Message: Handle modified OK
In the event of an error, the server will return a response of the form
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 1 Message: Permission denied.