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).

manager_default
boolean

organizations this one manages, in one step. The caller's organization must already manage at least one organization. To change the flag on a domain that is already registered and serving, use the manager-default endpoint instead of re-registering.

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.

manager_default
boolean

one manages serve their pages from when they have registered none of their own. At most one of an organization's domains carries it.

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