DomainsChild nameservers

Change a host's addresses

PATCH

/v1/domains/{id}/hosts/{host}

Replaces a host's full address list at the registrar. There is no rename: to change the name itself, delete this host and create one under the new name.

Authorization

apiKey

headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

host*string

The host name

Length4 <= length <= 253

Request Body

application/json

body

addresses*array<>

1 to 10 addresses this host answers on

Items1 <= items <= 10

Response Body

A host (child nameserver / glue record) registered at the registrar

application/json

response

A host (child nameserver / glue record) registered at the registrar

host*string

The host name, a hostname under the domain, like ns1.acme.com

Length4 <= length <= 253

addresses*array<>

1 to 10 addresses this host answers on

Items1 <= items <= 10

curl -X PATCH "https://example.com/v1/domains/dom_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/hosts/ns1.example-dns.com" \  -H "Content-Type: application/json" \  -d '{    "addresses": [      "203.0.113.10"    ]  }'

{  "host": "ns1.example-dns.com",  "addresses": [    "203.0.113.10"  ]}

Register a child nameserver POST

Registers a host (glue record) at the registrar, such as ns1.acme.com for acme.com, with the addresses it answers on. The host must be a hostname under this exact domain.

Delete a host DELETE

Deletes a host (glue record) at the registrar. Refused while any of your domains - including this one - still lists it as a nameserver.