DomainsChild nameservers

Register a child nameserver

POST

/v1/domains/{id}/hosts

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.

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

Request Body

application/json

body

host*string

The host name, under this domain, like ns1.acme.com

Length4 <= length <= 253

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 POST "https://example.com/v1/domains/dom_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/hosts" \  -H "Content-Type: application/json" \  -d '{    "host": "ns1.example-dns.com",    "addresses": [      "203.0.113.10"    ]  }'

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

List a domain's hosts GET

The child nameservers (glue records) registered at the registrar under this domain, such as ns1.acme.com for acme.com, each with the addresses it answers on. Hosts live at the registrar, not on this record, so this always reads them fresh.

Change a host's addresses PATCH

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.