Add custom domain

/api/v0/domainsPOST

Register a custom domain for a deployed project. Requires a Pro subscription. The domain must be CNAMEd to cname.holocron.so for SSL provisioning.

Request Bodyapplication/jsonrequired

projectId *string

Project ULID.

Min length: 1

hostname *string

Custom domain hostname (e.g. docs.mycompany.com).

Min length: 1Max length: 253

Response

200

id *string

hostname *string

status *string

sslStatus *string | null

cnameTarget *string

CNAME target for DNS configuration.

createdAt *number

400

error *string

402

error *string

409

error *string

Ask AI about this page

Request example

curl -X POST "https://api.example.com/api/v0/domains" \
  -H "Content-Type: application/json" \
  -d '{
  "projectId": "string",
  "hostname": "string"
}'