Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Zones

Update Zone

Update DNS zone and SOA record.

put/dns/v2/zones/{name}

Path parameters

namestring required

Request body

contactstring

email address of the administrator responsible for this zone

enabledboolean

If a zone is disabled, then its records will not be resolved on dns servers

expiryinteger

number of seconds after which secondary name servers should stop answering request for this zone

metaobject

arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default

namestring required

name of DNS zone

nx_ttlinteger

Time To Live of cache

primary_serverstring

primary master name server for zone

refreshinteger

number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.

retryinteger

number of seconds after which secondary name servers should retry to request the serial number

serialinteger

Serial number for this zone or Timestamp of zone modification moment. If a secondary name server slaved to this one observes an increase in this number, the slave will assume that the zone has been updated and initiate a zone transfer.

Example request

{
  "name": "example.com"
}

Response

UpdateZoneResponse

UpdateZoneResponse required