Skip to main content
POST
Create primary server

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234_abcdef

Path Parameters

zoneName
string
required

Body

application/json
address
string

Hostname or IP literal, optionally with a :port suffix. Public/routable IP literals are accepted; private, link-local, unspecified, and multicast IP literals are rejected with a 400 error. Hostnames and loopback addresses are accepted as-is and resolved only at transfer time.

meta
object
priority
integer<int64>
default:10

Priority of this primary relative to the zone's other primaries. Defaults to 10 when omitted; an explicit 0 is retained rather than replaced by the default.

Response

PrimaryServerResponse

address
string
consecutive_failures
integer<int64>
created_at
string<date-time>
enabled
boolean
id
integer<int64>
last_error_at
string<date-time>
last_error_msg
string
last_success_at
string<date-time>
meta
object
priority
integer<int64>
secondary_zone_id
integer<int64>
updated_at
string<date-time>