Custom Domains

Organization administrators can provision customer hostnames when Xentree has enabled their organization's custom-domain entitlement.

Configure domain

POST /api/admin/organizations/{org_id}/custom-domain

{
  "domain": "learn.customer.example"
}

Response contains cname_target, verification_status, and ssl_status. Point customer DNS CNAME at returned target, then poll status.

Domain conflict returns 409; provider failure returns 502; unavailable provider configuration returns 503.

GET /api/admin/organizations/{org_id}/custom-domain/status returns current stored state and refreshes pending provider status when possible.

Both endpoints require Bearer auth, organization administrator role, and entitlement. Keep provider credentials server-side.