Skip to Content
Uptimeify Docs

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

FeldTypPflichtStandardBeschreibung
domainIdnumberJa-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 authentifiziert
  • 403 Forbidden, wenn du organisationsweit ohne die Rolle Admin aufrufst
  • 403 Forbidden (managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rolle readonly, oder Token) und die Seite managed ist, ohne die Ausnahme canEditManaged des Kunden
  • 404 Not Found (domainNotFound), wenn du kundengebunden aufrufst und die Domain an keiner Statusseite hängt
  • 400 Bad Request, wenn die Domain noch nicht verifiziert ist
  • 409 Conflict (domainAlreadyClaimed), wenn eine andere Organisation diesen Hostnamen inzwischen verifiziert oder aktiviert hat. Wer das ist, wird nicht genannt.

Auf dieser Seite