Statusseiten-Vorlage erstellen
Legt eine Vorfall- oder Update-Vorlage an.
POST /api/status-pages/templates
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 |
|---|---|---|---|---|
kind | string | Ja | - | incident (neuer Vorfall) oder update (Update zu einem laufenden). Später nicht änderbar. |
name | string | Ja | - | 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 | Ja | - | 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. |
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 POST "$BASE_URL/api/status-pages/templates" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "kind": "incident", "name": "Payment provider down", "title": "Card payments failing", "body": "We are looking into failed card payments.", "severity": "major", "statusPageIds": [2], "componentIds": [8] }'Antwort
201 Created mit der neuen 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 gibt409 Conflict(statusPageLimitReached, mitdata.max), wenn die Organisation schon 200 Vorlagen hat401 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