Skip to content

Create a zone

POST /v1/dns/zones

Create a zone and request its publication. When the zone gets published, it becomes resolvable on the primary nameservers.

Body

application/json

Body Sample

{
"metadata": {
"public property": "public value"
},
"name": "example.com",
"nx_ttl": 60,
"request_publication": true,
"serial_epoch": 42
}

Body Description

metadata object

A collection of string key/value pairs that provide additional information or classification for an object.

* name string

The name of the zone.

Example: example.com

nx_ttl integer

Example: 60

Minimum: 0

request_publication boolean

Zone is to published (resolvable on Internet) upon creation

Example: true

serial_epoch integer

Initial serial number to use in published zone data (default: 1)

Example: 42

Minimum: 0

Response