---
title: "Schweregrad ändern"
description: "Setzt den Schweregrad eines Incident-Management-Incidents von Hand. Der Wert bleibt dann bestehen und wird nicht mehr aus den Alerts abgeleitet."
---

`POST /api/im/incidents/:id/severity`

Setzt den Schweregrad eines Incidents. Der Incident wird mit `severityManual: true` markiert, neue Alerts heben oder senken ihn also nicht mehr automatisch. Ist der Incident noch `triggered`, wird die anstehende Eskalation abgebrochen und mit dem neuen Schweregrad beim aktuellen Tier des Incidents neu scharf geschaltet. Statusseiten, die über eine [Statusseiten-Regel](/de/api/incident-management/statuspage-rules) gesteuert werden, und ausgehende Integrationen erfahren von der Änderung.

## 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. Anders als Lösen oder Statuswechsel hat dieser Einzel-Endpunkt keine Team-Einschränkung. (Die Aktion `severity` von [Incidents gesammelt ändern](/de/api/incident-management/bulk-update-incidents) schon.)

## Anfrage (Request Body)

| Feld | Typ | Erforderlich | Beschreibung |
|-------|------|----------|--------------|
| `severity` | string | Ja | Einer von `sev1`, `sev2`, `sev3`, `sev4`. |

## Beispiel (cURL)

```bash
curl -X POST "$BASE_URL/api/im/incidents/42/severity" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "severity": "sev2" }'
```

## Antwort (Response)

`200 OK`: der aktualisierte Incident-Datensatz (gleiche Form wie die `items` von [Incidents auflisten](/de/api/incident-management/list-incidents), ohne die Ergänzungsfelder), mit gesetztem `severity` und `severityManual: true`.

```json
{
  "id": 42,
  "teamId": 3,
  "title": "Database connection pool exhausted",
  "severity": "sev2",
  "severityManual": true,
  "status": "triggered",
  "currentTier": 1,
  "escalationEpoch": 1
}
```

(Gekürzt; zurück kommt der vollständige Datensatz.)

## Häufige Fehler

- `401 Unauthorized` wenn du nicht authentifiziert bist
- `403 Forbidden` (`customerScopedTokenForbidden`) bei Verwendung eines kunden-gescopten Tokens
- `403 Forbidden` (`imAccessDenied`) wenn die angemeldete Person keine IM-berechtigte Rolle hat
- `403 Forbidden` (`imNotEnabled`) wenn Incident Management für die Organisation nicht aktiviert ist
- `400 Bad Request` (`invalidRequestBody`) wenn `:id` keine positive Ganzzahl ist, oder `severity` fehlt oder nicht `sev1` bis `sev4` ist
- `404 Not Found` (`imIncidentNotFound`) wenn der Incident nicht existiert oder zu einer anderen Organisation gehört