---
title: "Incident Management"
description: "Öffentliche REST-API für Uptimeify Incident Management (IM): Alerts aus eigenen Monitoring-Systemen einspeisen und Incidents programmatisch verwalten."
---

Incident Management (IM) ist eine von Monitoring getrennte Domäne: ein zweistufiges Alert-/Incident-Modell mit Teams, On-Call-Zeitplänen und Eskalationsrichtlinien. Dieser Abschnitt beschreibt die öffentlichen REST-Endpunkte zum Einspeisen von Alerts und zum programmatischen Verwalten von Incidents.

## Authentifizierung

Jeder der folgenden Endpunkte erfordert einen **organisationsweiten** API-Token:

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

Erstelle einen über [Organisations-Token erstellen](/de/api/api-tokens/create-organization-token) und lasse `customerId` dabei weg. Ein Token, der **mit** einer `customerId` erstellt wurde (ein kunden-gescopter Token), wird immer mit `403 Forbidden` (`imAccessDenied`) abgelehnt; Incident Management hat bewusst keine kundenseitige Oberfläche.

Incident Management muss außerdem für deine Organisation **aktiviert** sein, sonst liefert jeder der folgenden Endpunkte `403 Forbidden` (`imNotEnabled`).

## Endpunkte

- [Events Ingest](./events-ingest): `POST /api/im/events`
- [Incidents auflisten](./list-incidents): `GET /api/im/incidents`
- [Incident abrufen](./get-incident): `GET /api/im/incidents/:id`
- [Incident erstellen](./create-incident): `POST /api/im/incidents`
- [Incident bestätigen / Status ändern](./acknowledge-incident): `POST /api/im/incidents/:id/status`
- [Incident lösen](./resolve-incident): `POST /api/im/incidents/:id/resolve`
- [Teams](./teams): `GET /api/im/teams`
- [Schedules](./schedules): `GET/POST /api/im/schedules`
- [Schedule-Overrides](./schedule-overrides): `GET/POST /api/im/schedules/:id/overrides`
- [Wer hat Bereitschaft](./on-call): `GET /api/im/on-call`

## Alert-Source-Einrichtungsanleitungen

Möchtest du Alarme lieber aus einem bestehenden Monitoring-Tool senden, statt die API direkt aufzurufen? Die [Alert-Source-Einrichtungsanleitungen](./alert-sources) enthalten Schritt-für-Schritt-Anleitungen für [Zabbix](./alert-sources/zabbix), [Datadog](./alert-sources/datadog), [Grafana Alerting](./alert-sources/grafana-alerting), [Prometheus Alertmanager](./alert-sources/prometheus-alertmanager), [Sentry](./alert-sources/sentry) und jeden [benutzerdefinierten Webhook](./alert-sources/custom-webhook). Jede nutzt ihre eigene, Source-spezifische Ingest-URL (`POST /api/im/ingest/:token`), getrennt vom oben genannten Events-Ingest-Endpunkt.

## Fehlercodes

Siehe [Fehlerliste und bekannte API-Fallen](/de/api/error-codes-and-known-pitfalls) für die vollständige Liste der `data.code`-Werte, die diese Endpunkte liefern können.