Komponentengruppen auflisten

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

Gruppen fassen Komponenten auf der öffentlichen Seite unter einer Überschrift zusammen. Die Liste enthält alle Gruppen der Seite auf einer einzigen Ergebnisseite, sortiert nach sort, dann id. Eine Seite hat höchstens 100 Gruppen.

ZugriffAnkerlink kopieren

Organisations-admin, editor und readonly. 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). :id nimmt die numerische ID oder die publicId der Status-Seite.

Beispiel (cURL)Ankerlink kopieren

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

curl -X GET "$BASE_URL/api/status-pages/1/groups" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

AntwortAnkerlink kopieren

200 OK

{
  "items": [
    {
      "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"
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 1
}

collapsed legt fest, ob die Gruppe auf der öffentlichen Seite zugeklappt startet.

Häufige FehlerAnkerlink kopieren

• 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