Statusseiten-Domain aktivieren
Aktiviert eine verifizierte eigene Domain für eine Statusseite. Org-weit nur Admin, kundengebunden nach der Eigentumsklasse der Seite.
POST /api/status-pages/domains/activate
Zugriff: Organisationsweite Aufrufer brauchen die Rolle admin (ein organisationsweites editor oder readonly bekommt 403 forbidden). Kundengebundene Nutzer (auch mit der Rolle readonly) und kundengebundene API-Tokens folgen der Eigentumsklasse der Seite, an der die Domain hängt: erlaubt auf self_service-Seiten, auf managed-Seiten nur mit der Ausnahme canEditManaged des Kunden, sonst 403 mit data.code: managed_by_organization. Eine Domain ohne Statusseite gibt es für einen kundengebundenen Aufrufer nicht: 404 (domainNotFound).
Request-Body
| Feld | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
domainId | number | Ja | - | Die ID der verifizierten Domain, die aktiviert werden soll |
Beispiel (cURL)
curl -X POST "$BASE_URL/api/status-pages/domains/activate" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "domainId": 42 }'Antwort
{
"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"
}
}Häufige Fehler
401 Unauthorized, wenn nicht authentifiziert403 Forbidden, wenn du organisationsweit ohne die Rolle Admin aufrufst403 Forbidden(managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rollereadonly, oder Token) und die Seitemanagedist, ohne die AusnahmecanEditManageddes Kunden404 Not Found(domainNotFound), wenn du kundengebunden aufrufst und die Domain an keiner Statusseite hängt400 Bad Request, wenn die Domain noch nicht verifiziert ist409 Conflict(domainAlreadyClaimed), wenn eine andere Organisation diesen Hostnamen inzwischen verifiziert oder aktiviert hat. Wer das ist, wird nicht genannt.