---
title: "Incident zu einem Monitoring-Incident finden"
description: "Ermittelt zu einer Monitoring-Incident-ID den Incident-Management-Incident, in den er übernommen wurde."
---

`GET /api/im/incidents/by-monitor/:id`

Ist die Monitoring-Brücke eingeschaltet (siehe [Organisationseinstellungen](/de/api/incident-management/org-settings)), wird jeder Incident aus Uptimeifys eigenem Monitoring zu einem Alarm in Incident Management und dort einem Incident zugeordnet. Dieser Endpunkt beantwortet, in welchem Incident-Management-Incident ein bestimmter **Monitoring**-Incident gelandet ist, etwa um von einem Monitoring-Incident auf seine Alarmierung und Timeline zu verlinken.

Es zählen nur Alarme der organisationseigenen Monitoring-Quelle. Ein eigener Webhook, der zufällig denselben Dedup-Schlüssel (`monitor:<id>`) sendet, wird nie getroffen. Wurde der Monitoring-Incident mehrfach übernommen, gewinnt der neueste Alarm.

## Authentifizierung

Jede IM-berechtigte Rolle (`admin`, `editor`, `responder`) oder ein organisationsweiter API-Token, siehe [Authentifizierung](/de/api/incident-management#authentifizierung). Incident Management muss für die Organisation aktiviert sein.

## Pfadparameter

| Parameter | Typ | Beschreibung |
|-----------|-----|--------------|
| `id` | number | Die ID des Monitoring-Incidents, wie sie [Incidents auflisten](/de/api/monitoring/list-incidents) der Monitoring-API liefert. |

## Beispiel (cURL)

```bash
curl -X GET "$BASE_URL/api/im/incidents/by-monitor/5123" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Antwort (Response)

```json
{
  "incidentId": 1834
}
```

Den Incident selbst lädst du mit [Incident abrufen](/de/api/incident-management/get-incident).

## Häufige Fehler

- `400 Bad Request` (`invalidRequestBody`) wenn `id` keine positive Zahl ist
- `401 Unauthorized` wenn du nicht authentifiziert bist
- `403 Forbidden` (`customerScopedTokenForbidden`) bei Verwendung eines kunden-gescopten Tokens
- `403 Forbidden` (`imAccessDenied`) wenn keine IM-berechtigte Rolle vorliegt
- `403 Forbidden` (`imNotEnabled`) wenn Incident Management für die Organisation nicht aktiviert ist
- `404 Not Found` (`imIncidentNotFound`) wenn der Monitoring-Incident (noch) nicht übernommen wurde oder zu einer anderen Organisation gehört