Skip to content
Sencai Logo Sencai Logo Sencai Docs

Create a dns-zone

POST
/dns-zones

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
data
object
provider
required
string
Allowed values: aws azure gcp cloudflare
name
required

Domain name (e.g. example.com) without trailing dot.

string
type
string
Allowed values: public private
provider_zone_id
required

Provider-side zone identifier (Route53 /hostedzone/Z…, Azure ARM path, GCP managed zone name, Cloudflare zone UUID).

string
records_count
integer
status
string
Allowed values: active importing error
organisation
One of:

DocumentId reference to api::organisation.organisation

string
credential
One of:

DocumentId reference to api::cloud-credential.cloud-credential

string
provider_metadata

Provider-specific metadata (name servers, comments, etc.).

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Created

object
data
object
provider
required
string
Allowed values: aws azure gcp cloudflare
name
required

Domain name (e.g. example.com) without trailing dot.

string
type
string
Allowed values: public private
provider_zone_id
required

Provider-side zone identifier (Route53 /hostedzone/Z…, Azure ARM path, GCP managed zone name, Cloudflare zone UUID).

string
records_count
integer
status
string
Allowed values: active importing error
organisation
One of:

DocumentId reference to api::organisation.organisation

string
credential
One of:

DocumentId reference to api::cloud-credential.cloud-credential

string
provider_metadata

Provider-specific metadata (name servers, comments, etc.).

documentId
string
id
integer
createdAt
string format: date-time
updatedAt
string format: date-time
publishedAt
string format: date-time
nullable

400

Section titled “400 ”

Validation error

401

Section titled “401 ”

Missing or invalid authentication

403

Section titled “403 ”

Not authorized (tenant scope or capability)