Deutsch English

Verlaufseintrag veröffentlichen

POST /api/v1/incidents/:incident/updates

Enthält den neuen Status, den Text und optional geänderte Komponenten-Auswirkungen; benachrichtigt Abonnenten mit diesem Text. Ein terminaler Status schließt den Vorfall.

Erforderliche Berechtigung

incidents.manage Vorfälle und Wartungen verwalten

URL Variablen

Name Beschreibung
incident Numerische ID des Vorfalls bzw. Wartungsfensters. Beide Collections liegen auf einem Modell — deshalb heißt der Platzhalter auch auf den Wartungs-Routen {incident}.

Body Parameter (application/json)

Name Format Beschreibung Optional
status Status, die ein VORFALL annehmen kann (IncidentStatus::forType). —
body string Locale-Objekt wie bei title. Markdown erlaubt. —
components string Liste betroffener Komponenten als JSON-Array, je Eintrag {"id": 3, "impact": "degraded"}. Erlaubte Auswirkungen: degraded, partial_outage, major_outage, under_maintenance.
posted_at string
notify boolean

Response (application/json) 

{1 Eigenschaft
  "data": {6 Eigenschaften
    "id": 41,
    "incident_id": 12,
    "status": "monitoring",
    "body": {2 Eigenschaften
      "de": "Ursache gefunden, wir beobachten.",
      "en": "Cause identified, monitoring."
    },
    "posted_at": "2026-07-27T14:20:00Z",
    "created_at": "2026-07-27T14:20:00Z"
  }
}
{1 Eigenschaft
  "message": "Incident not found."
}
{2 Eigenschaften
  "message": "The body field must be filled in at least one language (de, en).",
  "errors": {1 Eigenschaft
    "body": [1 Element
      "The body field must be filled in at least one language (de, en)."
    ]
  }
}

cURL

curl -X POST 'https://status.example.com/api/v1/incidents/:incident/updates' \
  -H 'Authorization: Bearer fs_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"status":"VALUE","body":"VALUE","components":"VALUE","posted_at":"VALUE","notify":"VALUE"}'