---
title: "Komponentengruppe erstellen"
description: "Fügt einer Status-Seite eine Komponentengruppe hinzu."
---

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

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

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

Komponenten kommen über `groupId` in die Gruppe, bei [Komponente erstellen](/de/api/status-pages/create-status-page-component), [Komponente aktualisieren](/de/api/status-pages/update-status-page-component) oder [Komponenten sortieren](/de/api/status-pages/reorder-status-page-components).

## Beispiel (cURL)

```bash
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" }'
```

## Antwort

`201 Created` mit der neuen Gruppe:

```json
{
  "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 Fehler

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