DNS Zones

Update Zone Soa

put/dns/zones/{zone_uuid}/soa

Update SOA settings for a DNS zone.

The serial number is incremented automatically.

Authorization

Authorization*string

Bearer YOUR_API_TOKEN with an API token. The X-API-Key: YOUR_API_TOKEN header works too.

Path parameters

zone_uuid*string

Request body

Update SOA settings for a DNS zone

application/jsonRequired

refresh?integer | null

Refresh interval in seconds (300-86400)

Range300 ≤ value ≤ 86400

retry?integer | null

Retry interval in seconds (60-86400)

Range60 ≤ value ≤ 86400

expire?integer | null

Expire time in seconds (86400-2419200)

Range86400 ≤ value ≤ 2419200

minimum?integer | null

Minimum/negative caching TTL in seconds (60-86400)

Range60 ≤ value ≤ 86400

hostmaster?string | null

Hostmaster email (e.g., [email protected])

Rangelength ≤ 255

Responses

Successful Response

application/json

serial*integer

refresh*integer

retry*integer

expire*integer

minimum*integer

primary_ns*string

hostmaster*string

Example request

PUT/dns/zones/{zone_uuid}/soa

curl -X PUT "https://api.cubepath.com/dns/zones/3fa85f64-5717-4562-b3fc-2c963f66afa6/soa" \
  -H "Authorization: Bearer $CUBEPATH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "refresh": 3600,
  "retry": 600,
  "expire": 604800,
  "minimum": 300,
  "hostmaster": "[email protected]"
}'

Example response

{
  "serial": 1,
  "refresh": 1,
  "retry": 1,
  "expire": 1,
  "minimum": 1,
  "primary_ns": "string",
  "hostmaster": "string"
}