Domain Zones

Per-org wildcard domain-zone ownership — claim a base domain (TXT-verified) so its subdomains can be attached to stacks.

List the org's domain zones

GET

/api/v1

/org/domain-zones

auth_token (cookie)

Bearer

Returns the wildcard domain-zone ownership claims for the authenticated user's organization, with their verification status.

List the org's domain zones › Responses

List of domain zones

object[]

Claim a wildcard domain zone

POST

/api/v1

/org/domain-zones

auth_token (cookie)

Bearer

Registers a wildcard-zone ownership claim on a base domain for the org. The base is only reserved exclusively once verified (a best-effort TXT record check runs), so distinct orgs may hold pending claims on the same base concurrently. Requires a verified email.

Claim a wildcard domain zone › Request Body

baseDomain

string · required

The base domain to claim (e.g. example.com)

Claim a wildcard domain zone › Responses

Domain zone claim created

Force-verify a domain zone

POST

/api/v1

/org/domain-zones/{zoneId}/verify

auth_token (cookie)

Bearer

Re-runs the TXT-record ownership check for a pending domain-zone claim and, on success, marks it verified (reserving the base exclusively).

Force-verify a domain zone › path Parameters

zoneId

string · uuid · required

Domain-zone UUID

Force-verify a domain zone › Responses

Verification result

Delete a domain zone

DELETE

/api/v1

/org/domain-zones/{zoneId}

auth_token (cookie)

Bearer

Removes the org's ownership claim on a base domain.

Delete a domain zone › path Parameters

zoneId

string · uuid · required

Domain-zone UUID

Delete a domain zone › Responses

Domain zone deleted

No data returned

Volumes Webhooks