Manuellen Vorfall anlegen

POST /api/incidents

Legt einen manuellen Vorfall an: eine Meldung auf Statusseiten, von Ihnen geschrieben statt von einem Monitor erkannt. Mit customerId erscheint er wie bisher auf jeder Statusseite dieses Kunden. Seit dem 27. Oktober 2026 ist customerId optional: mit statusPageIds erscheint der Vorfall auf diesen Seiten, seitenweit oder auf den Komponenten aus componentIds, auch auf einer Seite ohne Kunden oder ohne einen einzigen Monitor. Die Abonnenten jeder Seite, auf der er erscheint, werden benachrichtigt.

AuthentifizierungAnkerlink kopieren

Erfordert die Rolle admin oder editor (oder einen Organisations-API-Token). Ohne customerId gehört der Vorfall der Organisation, wie eine Statusseite ohne Kunden: ein kundengebundenes Login oder Token bekommt 403 forbidden. Jede Seite in statusPageIds muss zu Ihrer Organisation gehören (sonst 404 statusPageNotFound) und in Ihrem Kundenbereich liegen.

• Header: Authorization: Bearer <token>

Anfrage (Request Body)Ankerlink kopieren

Beispiel (cURL)Ankerlink kopieren

curl -X POST "$BASE_URL/api/incidents" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Card payments failing",
    "severity": "major",
    "statusPageIds": ["2b9c7d1e-5f3a-4c8b-9e0d-1a2b3c4d5e6f"],
    "componentIds": [8],
    "updateStatus": "investigating",
    "updateBody": "We are looking into failed card payments."
  }'

Antwort (Response)Ankerlink kopieren

201 Created

{
  "incident": {
    "id": 5121,
    "publicId": "8d1f0c2e-6a2b-4f1e-9b7c-2e5a1d3c4b5a"
  }
}

Häufige FehlerAnkerlink kopieren

• 400 Bad Request (incidentTargetRequired), wenn weder customerId noch statusPageIds angegeben ist
• 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
• 400 Bad Request (statusPageCustomerMismatch), wenn eine Seite einem anderen Kunden als customerId gehört
• 400 Bad Request (invalidWebsite), wenn die Website nicht zu customerId gehört oder websiteId ohne customerId kommt
• 400 Bad Request (invalidRequestBody), wenn ein Feld fehlt oder Typ oder Wert falsch ist
• 401 Unauthorized, wenn Sie nicht authentifiziert sind
• 403 Forbidden (forbidden), wenn Ihre Rolle keine Statusseiten schreiben darf, oder ein kundengebundener Aufrufer einen Vorfall ohne Kunden oder auf einer Seite außerhalb seines Bereichs anlegt
• 403 Forbidden (statusPagesModuleDisabled), wenn statusPageIds nicht leer ist und das Statusseiten-Modul für Ihre Organisation nicht aktiviert ist; Vorfälle ohne Statusseiten sind nicht betroffen
• 404 Not Found (statusPageNotFound, statusPageComponentNotFound, customerNotFound), wenn eine Seite, Komponente oder ein Kunde in Ihrer Organisation nicht existiert