Skip to Content
Uptimeify Docs
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

FieldTypeRequiredDefaultDescription
domainIdnumberYes-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 Unauthorized when not authenticated
  • 403 Forbidden when you are an organization-wide caller without the role admin
  • 403 Forbidden (managed_by_organization) when you are customer-bound (user, also with the role readonly, or token) and the page is managed without the customer's canEditManaged exception
  • 404 Not Found (domainNotFound) when you are customer-bound and the domain is bound to no status page
  • 400 Bad Request when the domain is not yet verified
  • 409 Conflict (domainAlreadyClaimed) when another organization holds this hostname as verified or active meanwhile. The owner is not disclosed.

On this page