Skip to main content
POST
Add

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

orgId
string
required

The organization's id (UUID) or slug — either form is accepted.

projectId
string
required

The project's id (UUID) or slug — either form is accepted.

Body

application/json
hostname
string
required

Hostname you control, e.g. "app.acme.com".

Pattern: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,}$
environment
string

Environment the domain routes to. Defaults to "production". An environment that does not exist on the project answers 404. The preview environment answers 422: preview apps are ephemeral per-pull-request deployments, so a stable hostname can never attach to them.

Pattern: ^[a-z][a-z0-9-]{0,38}$

Response

Domain registered. Create the CNAME from the instructions, then check the domain until it goes active.

id
string
required
hostname
string
required
Pattern: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,}$
environment
string
required

Slug of the environment this domain routes to.

Pattern: ^[a-z][a-z0-9-]{0,38}$
status
enum<string>
required

Verification state: pending_dns until the CNAME points at the platform, pending_ssl while the certificate is issued, then active. failed is terminal.

Available options:
pending_dns,
pending_ssl,
active,
failed
verificationErrors
string | null
required

Why verification is stuck, when the edge reported a reason.

instructions
string
required

DNS setup step. Production domains target the project's managed subdomain, e.g. "CNAME app.acme.com → my-app.korve.app"; domains on other environments target that environment's own subdomain, e.g. "CNAME staging.acme.com → my-app-staging.korve.app".

createdAt
string<date-time>