Latest revision as of 12:25, 31 January 2014

[edit] DELETE /domains/{domainName}/hosts/{hostName}

Delete a single host from a domain. To delete multiple hosts you can use the "replace hosts" feature.

[edit] Request

DELETE /domains/{domainName}/hosts/{hostName}

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

hostName - string

The name of the host to delete.

[edit] Request Headers

Content-Type: application/json

[edit] Request Body

None.

[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

[edit] Example of deleting a host

Request

DELETE /domains/example.com/hosts/ns1.example.com
 

Response

204 No Content
 

[edit] See also

• Domain Name Registration API
• Common Features