Status pages
Verify Status Page Domain
Verifies DNS TXT records for a custom status page domain. Admin-only.
POST /api/status-pages/domains/verify
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
domainId | number | Yes | The domain ID to verify |
Example (cURL)
curl -X POST "$BASE_URL/api/status-pages/domains/verify" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "domainId": 42 }'Response (success)
{
"verified": true,
"status": "verified",
"domain": {
"id": 42,
"hostname": "status.deinkunde.com",
"status": "verified",
"role": "status_page",
"verificationToken": "abc123-def456-ghi789",
"verifiedAt": "2026-05-01T12:00:00.000Z",
"createdAt": "2026-05-01T11:00:00.000Z",
"updatedAt": "2026-05-01T12:00:00.000Z"
}
}Common errors
401 Unauthorizedwhen not authenticated403 Forbiddenwhen not an admin404 Not foundwhen the domain does not exist409 Conflict(domainAlreadyClaimed) when another organization has already verified or activated this hostname. The owner is not disclosed.
Update Status Page Design
Updates the visual design configuration of a status page. Only the fields you provide are changed. All other settings keep their current values. Requires admin role.
Service Status
Public, unauthenticated endpoint that returns Uptimeify's own platform availability, check and alert delivery percentages, component states, and the hash-chained frozen monthly totals.