Uptimeify Docs

Komponentengruppe aktualisieren

Benennt eine Komponentengruppe um, verschiebt oder klappt sie zu.

PATCH /api/status-pages/{id}/groups/{groupId}

Zugriff

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-Body (alle optional, mindestens ein Feld)

FeldTypBeschreibung
namestringÜberschrift der Gruppe (1-120 Zeichen).
sortnumberPosition, 0-100000.
collapsedbooleanAuf der öffentlichen Seite zugeklappt starten.

Beispiel (cURL)

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

curl -X PATCH "$BASE_URL/api/status-pages/1/groups/3" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "collapsed": true }'

Antwort

200 OK mit der geänderten Gruppe, in derselben Form wie bei Komponentengruppen auflisten.

Häufige Fehler

  • 400 Bad Request (invalidRequestBody), wenn der Body leer 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
  • 404 Not Found (statusPageComponentGroupNotFound), wenn es die Gruppe auf dieser Seite nicht gibt

Auf dieser Seite