Incident löschen (nur manuell)

Löscht einen manuell erstellten (Statusseiten-)Incident. Vom Monitoring erzeugte Incidents können nicht gelöscht werden.

DELETE /api/incidents/:id

Löscht einen manuellen Incident (eine von einem Admin erstellte Statusseiten-Ankündigung) samt seiner Timeline-Updates. Vom Monitoring erzeugte Incidents gehören den Workern und können niemals gelöscht werden, der Endpunkt lehnt sie mit 403 notManualIncident ab.

Authentifizierung

Erfordert eine gültige Session mit Editor-/Admin-Rechten, eingeschränkt auf den Kunden des Incidents.

Header: Authorization: Bearer <token>

Pfad-Parameter

id (erforderlich): Die numerische ID des Incidents oder seine publicId (UUID).

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X DELETE "$BASE_URL/api/incidents/8d1f0c2e-6a2b-4f1e-9b7c-2e5a1d3c4b5a" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Antwort

{
  "ok": true
}

Häufige Fehler

400 Incident id is required wenn keine ID übergeben wird
400 Invalid Incident identifier wenn die ID weder eine numerische Incident-ID noch eine UUID ist
401 Unauthorized wenn du nicht angemeldet bist
403 Forbidden wenn du keine Schreibrechte für den Kunden des Incidents hast
403 Only manual incidents can be deleted (data.code: notManualIncident) wenn der Incident vom Monitoring erzeugt wurde
404 Incident not found wenn kein Incident zur ID passt