---
title: "Statusseiten-Vorlage aktualisieren"
description: "Ändert Felder einer Vorlage; null leert ein optionales Feld."
---

`PATCH /api/status-pages/templates/{id}`

Eine Vorlage füllt das Formular für einen neuen öffentlichen Vorfall (`kind: incident`) oder für ein Update zu einem laufenden (`kind: update`) vor. Sie veröffentlicht selbst nichts; Vorfälle entstehen weiter mit [Vorfall anlegen](/de/api/monitoring/create-manual-incident).

## Zugriff

Organisations-`admin` und `editor` mit uneingeschränktem Umfang: ein kundengebundener Login oder API-Token bekommt `403` (`customerScopedTokenForbidden`), weil eine Vorlage der ganzen Organisation gehört. Eine Vorlage einer anderen Organisation antwortet `404` (`statusPageTemplateNotFound`). Pfad-IDs nehmen die numerische ID oder die `publicId`. Die Änderung steht im Audit-Log der Organisation.

## Request-Body

| Feld | Typ | Pflicht | Vorgabe | Beschreibung |
|------|-----|---------|---------|--------------|
| `name` | string | Nein | - | Steht in der Vorlagen-Auswahl, 1 bis 120 Zeichen. |
| `title` | string oder null | Nein | `null` | Nur Vorfall-Vorlagen: der Titel des Vorfalls, bis 200 Zeichen. |
| `body` | string | Nein | - | Der Text des Updates, 1 bis 5.000 Zeichen. |
| `updateStatus` | string | Nein | `investigating` | Phase, mit der das Update beginnt: `investigating`, `identified`, `monitoring` oder `resolved`. |
| `severity` | string oder null | Nein | `null` | Nur Vorfall-Vorlagen: `minor`, `major`, `critical` oder `maintenance`. |
| `impact` | string oder null | Nein | `null` | Nur Vorfall-Vorlagen: `degraded`, `partial_outage`, `major_outage` oder `maintenance`. |
| `statusPageIds` | array oder null | Nein | `null` | Nur Vorfall-Vorlagen: vorausgewählte Status-Seiten (ID oder publicId), höchstens 10. Jede muss zu deiner Organisation gehören. |
| `componentIds` | array oder null | Nein | `null` | Nur Vorfall-Vorlagen: Komponenten (ID oder publicId), höchstens 100; jede muss zu einer der `statusPageIds` gehören. |

Mindestens ein Feld. `statusPageIds` und `componentIds` werden zusammen geprüft: ein weggelassenes Feld behält seinen gespeicherten Wert.

Eine Update-Vorlage (`kind: update`) nimmt nur `name`, `body` und `updateStatus`; die Felder für Vorfall-Vorlagen bleiben `null`.

## Beispiel (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X PATCH "$BASE_URL/api/status-pages/templates/4" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "body": "We have identified the cause and are working on a fix.", "updateStatus": "identified" }'
```

## Antwort

`200 OK` mit der geänderten Vorlage:

```json
{
  "id": 4,
  "publicId": "3f6c2a1b-8d4e-4b7a-9c1d-2e3f4a5b6c7d",
  "kind": "incident",
  "name": "Payment provider down",
  "title": "Card payments failing",
  "body": "We are looking into failed card payments.",
  "updateStatus": "investigating",
  "severity": "major",
  "impact": "partial_outage",
  "statusPageIds": [2],
  "componentIds": [8],
  "createdAt": "2026-10-27T09:00:00.000Z",
  "updatedAt": "2026-10-27T09:00:00.000Z"
}
```

## Häufige Fehler

- `400 Bad Request` (`invalidRequestBody`), wenn ein Feld ungültig ist oder eine Update-Vorlage ein Feld nur für Vorfall-Vorlagen bekommt
- `400 Bad Request` (`statusPageIdsRequired`), wenn `componentIds` ohne `statusPageIds` kommt
- `400 Bad Request` (`statusPageComponentNotOnPage`), wenn eine Komponente zu einer Seite gehört, die nicht in `statusPageIds` steht
- `404 Not Found` (`statusPageNotFound`, `statusPageComponentNotFound`), wenn es Seite oder Komponente in deiner Organisation nicht gibt
- `400 Bad Request` (`invalidIdentifier`), wenn die ID weder Zahl noch UUID ist
- `404 Not Found` (`statusPageTemplateNotFound`), wenn es die Vorlage nicht gibt oder sie einer anderen Organisation gehört
- `401 Unauthorized`, wenn du nicht angemeldet bist
- `403 Forbidden` (`statusPagesModuleDisabled`), wenn das Statusseiten-Modul nicht aktiviert ist
- `403 Forbidden` (`forbidden`), wenn deine Rolle nicht schreiben darf
- `403 Forbidden` (`customerScopedTokenForbidden`) für einen kundengebundenen Login oder Token