Statusseiten-Vorlage aktualisieren
Ä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.
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)
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:
{
"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 bekommt400 Bad Request(statusPageIdsRequired), wenncomponentIdsohnestatusPageIdskommt400 Bad Request(statusPageComponentNotOnPage), wenn eine Komponente zu einer Seite gehört, die nicht instatusPageIdssteht404 Not Found(statusPageNotFound,statusPageComponentNotFound), wenn es Seite oder Komponente in deiner Organisation nicht gibt400 Bad Request(invalidIdentifier), wenn die ID weder Zahl noch UUID ist404 Not Found(statusPageTemplateNotFound), wenn es die Vorlage nicht gibt oder sie einer anderen Organisation gehört401 Unauthorized, wenn du nicht angemeldet bist403 Forbidden(statusPagesModuleDisabled), wenn das Statusseiten-Modul nicht aktiviert ist403 Forbidden(forbidden), wenn deine Rolle nicht schreiben darf403 Forbidden(customerScopedTokenForbidden) für einen kundengebundenen Login oder Token