Domains-domainName-privateregistration:POST
From Hostway API Documentation
(Difference between revisions)
(→POST /domains/{domainName}/privateregistration) |
Mike.robski (Talk | contribs) m (1 revision: Release 90) |
Latest revision as of 12:34, 31 January 2014
[edit] POST /domains/{domainName}/privateregistration
Update the privateregistration for a domain - change forwarding e-mail address, upgrade or downgrade between "full" and "light" version of the privateregistration product.
Contents
|
[edit] Request
POST /domains/{domainName}/privateregistration
[edit] Parameters
None.
[edit] URI Parameters
- domainName - string
- The domain name. IE: example.com is a valid domain name, whereas http://www.example.com or www.example.com are not. If the domain name is invalid, or is otherwise not registerable such as for a non-existent or non-supported TLD, an error will be returned. Domain names are case insensitive. The domain name must be an open or suspended product under the authenticated franchise.
[edit] Request Headers
Content-Type: application/json
[edit] Request Body
The hosts for the domain.
[edit] Parameters
- type - string
- (Optional) The privateregistration product type, either "full" or "light". If it's different than the current type, product will be upgraded or downgraded to match the new type.
- email - string
- (Optional) The forwarding e-mail address for "full" type privateregistration.
[edit] Response
[edit] Status Code
- 204 No Content
- Returned on success
- 404 Not Found
- No domain records found for the given domain name.
- 500 Internal Server Error
- An error has occurred with the registry,
[edit] Response Body
None.
[edit] Example of updating e-mail address for "full" type of privateregistration.
Request
POST /domains/example.com/privateregistration
{ "email": "test-changed@test.com" }
Response
204 No Content
[edit] Example of downgrading "full" type of privateregistration to "light".
Request
POST /domains/example.com/privateregistration
{ "type": "light" }
Response
204 No Content
[edit] Example of upgrading "light" type of privateregistration to "full".
Request
POST /domains/example.com/privateregistration
{ "type": "full", "email": "test-forward@test.com" }
Response
204 No Content
[edit] See also
