Komponentengruppe erstellen

POST /api/status-pages/{id}/groups

ZugriffAnkerlink kopieren

Organisations-admin und editor. Ein kundengebundener Nutzer oder API-Token erreicht nur Seiten eines Kunden in seinem Bereich; eine Seite ohne Kunde (customerId: null) beantwortet ihm 403 (forbidden). Eine Seite einer anderen Organisation antwortet 404 (statusPageNotFound). IDs im Pfad nehmen die numerische ID oder die publicId. Die Änderung steht im Audit-Protokoll der Organisation.

Request-BodyAnkerlink kopieren

Komponenten kommen über groupId in die Gruppe, bei Komponente erstellen, Komponente aktualisieren oder Komponenten sortieren.

Beispiel (cURL)Ankerlink kopieren

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X POST "$BASE_URL/api/status-pages/1/groups" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Core services" }'

AntwortAnkerlink kopieren

201 Created mit der neuen Gruppe:

{
  "id": 3,
  "publicId": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
  "statusPageId": 1,
  "name": "Core services",
  "sort": 0,
  "collapsed": false,
  "createdAt": "2026-10-27T08:55:00.000Z",
  "updatedAt": "2026-10-27T08:55:00.000Z"
}

Häufige FehlerAnkerlink kopieren

• 400 Bad Request (invalidRequestBody), wenn name fehlt oder ein Feld ungültig ist
• 400 Bad Request (invalidIdentifier), wenn eine ID im Pfad weder Zahl noch UUID ist
• 401 Unauthorized, wenn du nicht angemeldet bist
• 403 Forbidden (forbidden), wenn deine Rolle das nicht darf, oder für einen kundengebundenen Aufrufer auf einer Seite ohne Kunde oder eines anderen Kunden
• 403 Forbidden (statusPagesModuleDisabled), wenn das Statusseiten-Modul nicht aktiviert ist
• 404 Not Found (statusPageNotFound), wenn die Status-Seite nicht existiert oder zu einer anderen Organisation gehört
• 409 Conflict (statusPageLimitReached, mit data.max), wenn die Seite schon 100 Gruppen hat