Skip to main content
POST
CreateCustomDomainAPI registers a custom domain for the caller's org and

Authorizations

Authorization
string
header
required

An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).

Body

application/json
domain
string

customer controls (e.g. "pages.acme.com"; root domains cannot CNAME).

Response

Success response

created_at
string
dns_records
CustomDomainDNSRecord is one DNS record the customer must create at their · object[]

provider — shown until (and after) the domain validates, so a stuck domain can be re-checked against what should exist.

domain
string

"pages.acme.com". It is the identifier every other custom-domain endpoint takes.

error_reason
string

disabled (e.g. a CAA record blocking certificate issuance); empty otherwise.

last_checked_at
string

(RFC 3339); empty if never checked yet.

status
string

customer's DNS records), "pending_cert" (ownership verified, certificate issuing), "active" (serving), "failed" (validation or issuance error — see error_reason), or "disabled" (deregistered upstream). This is read from the same record the serving path consults, kept reconciled against the CDN by a monitoring job.

updated_at
string