Skip to main content
PATCH
SetCustomDomainHomeAPI changes what the domain root serves.

Authorizations

Authorization
string
header
required

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

Path Parameters

domain
string
required

Body

application/json
home_artifact_id
string | null

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.

home_artifact_id
string | null
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