Incident löschen (nur manuell)

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.

AuthentifizierungAnkerlink kopieren

Im Kundenbereich des Vorfalls. Ist der Vorfall mit Statusseiten verknüpft, muss jede verknüpfte Seite es erlauben: organisationsweite Aufrufer brauchen die Rolle admin oder editor; kundengebundene Nutzer (auch mit der Rolle readonly) und kundengebundene API-Tokens brauchen self_service-Seiten oder managed-Seiten mit der Ausnahme canEditManaged des Kunden (sonst 403 managed_by_organization). Ein Vorfall ohne verknüpfte Seite folgt weiter der Rolle: admin oder editor.

• Header: Authorization: Bearer <token>

Pfad-ParameterAnkerlink kopieren

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

Beispiel (cURL)Ankerlink kopieren

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"

AntwortAnkerlink kopieren

{
  "success": true,
  "ok": true
}

ok ist veraltet und bleibt für bestehende Leser; bitte success lesen.

Häufige FehlerAnkerlink kopieren

• 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 Forbidden (managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rolle readonly, oder Token) und eine beteiligte Statusseite managed ist, ohne die Ausnahme canEditManaged des Kunden
• 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