Sign in

v1

latestOpenAPI 3.1.02026-07-2671111437.2 KB
Vanity Nameservers

Update Vanity Nameserver IP

Updates the glue record IP addresses for a vanity nameserver.

put/core/v1/domains/{domainName}/vanity_nameservers/{hostname}

Path parameters

domainNamestring hostname required
Example:example.com

The domain name associated with the vanity nameserver.

hostnamestring hostname required
Example:ns1.example.com

The hostname of the vanity nameserver to update.

Request body

ipsstring[]

IPs is the updated list of IP addresses to be used for glue records for this vanity nameserver. Providing an empty array will remove all existing IPs.

Example request

{
  "ips": [
    "192.168.1.10",
    "2001:0db8:85a3:0000:0000:8a2e:0370:7334"
  ]
}

Response

Vanity nameserver successfully updated.

domainNamestring hostname required

DomainName is the root domain for which this vanity nameserver is created. For example, if the hostname is 'ns1.example.com', the domainName would be 'example.com'.

hostnamestring hostname required

Hostname is the fully qualified domain name (FQDN) of the vanity nameserver. It must be a subdomain of the domain specified in 'domainName'.

ipsstring[] required

IPs is a list of IP addresses that are used for glue records for this vanity nameserver. These should be valid IPv4 or IPv6 addresses.

Example response

{
  "domainName": "example.com",
  "hostname": "ns1.example.com",
  "ips": [
    "192.168.1.1",
    "2001:0db8:85a3:0000:0000:8a2e:0370:7334"
  ]
}