---
title: "Komponentengruppe aktualisieren"
description: "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)

| Feld | Typ | Beschreibung |
|------|-----|--------------|
| `name` | string | Überschrift der Gruppe (1-120 Zeichen). |
| `sort` | number | Position, 0-100000. |
| `collapsed` | boolean | Auf der öffentlichen Seite zugeklappt starten. |

## Beispiel (cURL)

```bash
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](/de/api/status-pages/list-status-page-component-groups).

## 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