DNS Zones

Create Dns Zone

post/dns/zones

Create a new empty DNS zone.

Authorization

Authorization*string

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

Request body

Create a new DNS zone

application/jsonRequired

domain*string

Domain name (e.g., example.com)

Range4 ≤ length ≤ 253

project_id*integer

Project ID to associate the zone with

Responses

Successful Response

application/json

uuid*string

domain*string

status*DNSZoneStatus

Value in"pending_verification""verification_failed""active""suspended""deleting"

verified_at?string | null

Formatdate-time

project_id*integer

records_count?integer

Default0

dns_tier?integer

Default1

nameservers*array<string>

created_at*string

Formatdate-time

updated_at*string

Formatdate-time

Example request

POST/dns/zones

curl -X POST "https://api.cubepath.com/dns/zones" \
  -H "Authorization: Bearer $CUBEPATH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "example.com",
  "project_id": 1
}'

Example response

{
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "domain": "string",
  "status": "pending_verification",
  "verified_at": "2026-01-01T00:00:00Z",
  "project_id": 1,
  "records_count": 0,
  "dns_tier": 1,
  "nameservers": [
    "string"
  ],
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}