Status pages
Activate Status Page Domain
Activates a verified custom domain for a status page. Organization-wide: admin only; customer-bound: by the page's ownership class.
POST /api/status-pages/domains/activate
Access: organization-wide callers need the role admin (an organization-wide editor or readonly gets 403 forbidden). Customer-bound users (also with the role readonly) and customer-bound API tokens follow the ownership class of the page the domain is bound to: allowed on self_service pages, on managed pages only with the customer's canEditManaged exception, otherwise 403 with data.code: managed_by_organization. A domain bound to no status page does not exist for a customer-bound caller: 404 (domainNotFound).
Request Body
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
domainId | number | Yes | - | The verified domain ID to activate |
Example (cURL)
curl -X POST "$BASE_URL/api/status-pages/domains/activate" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "domainId": 42 }'Response
{
"activated": true,
"domain": {
"id": 42,
"hostname": "status.deinkunde.com",
"status": "active",
"role": "status_page",
"isPrimary": false,
"verificationToken": "abc123-def456-ghi789",
"verifiedAt": "2026-05-01T12:00:00.000Z",
"lastVerificationError": null,
"lastVerificationErrorAt": null,
"createdAt": "2026-05-01T11:00:00.000Z",
"updatedAt": "2026-05-01T12:30:00.000Z"
}
}Common errors
401 Unauthorizedwhen not authenticated403 Forbiddenwhen you are an organization-wide caller without the role admin403 Forbidden(managed_by_organization) when you are customer-bound (user, also with the rolereadonly, or token) and the page ismanagedwithout the customer'scanEditManagedexception404 Not Found(domainNotFound) when you are customer-bound and the domain is bound to no status page400 Bad Requestwhen the domain is not yet verified409 Conflict(domainAlreadyClaimed) when another organization holds this hostname as verified or active meanwhile. The owner is not disclosed.