---
title: "Incident schlummern lassen"
description: "Pausiert Eskalation und Erinnerungen eines offenen Incident-Management-Incidents bis zu einem Zeitpunkt (höchstens 7 Tage voraus) oder beendet das Schlummern vorzeitig."
---

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

Pausiert Eskalation und Erinnerungen eines offenen Incidents bis `snoozedUntil`. Anstehende Eskalations-Jobs werden abgebrochen, die Alarmierung läuft nach Ablauf automatisch weiter. Mit `null` (oder ohne das Feld) endet das Schlummern sofort: ein `triggered`-Incident eskaliert dann gleich ab seinem aktuellen Tier weiter. Jeder Aufruf wird in der Timeline des Incidents vermerkt.

## 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.

Dem Team des Incidents vorbehalten: du musst Mitglied im Team des Incidents (`teamId`) oder Organisations-Admin sein. Ein organisationsweiter API-Token gilt dabei als Organisations-Admin.

## Anfrage (Request Body)

| Feld | Typ | Erforderlich | Beschreibung |
|-------|------|----------|--------------|
| `snoozedUntil` | ISO-8601-Datum/Zeit oder null | Nein | Wann die Alarmierung weiterläuft. Muss in der Zukunft liegen, höchstens 7 Tage ab jetzt. `null` oder weggelassen beendet das Schlummern. |

## Beispiel (cURL)

```bash
curl -X POST "$BASE_URL/api/im/incidents/42/snooze" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "snoozedUntil": "2026-07-17T13:00:00.000Z" }'
```

Schlummern vorzeitig beenden:

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

## 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).

```json
{
  "id": 42,
  "teamId": 3,
  "title": "Database connection pool exhausted",
  "severity": "sev1",
  "status": "triggered",
  "currentTier": 1,
  "escalationEpoch": 2,
  "snoozedUntil": "2026-07-17T13:00:00.000Z"
}
```

(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
- `403 Forbidden` (`imTeamMembershipRequired`) wenn du weder Mitglied im Team des Incidents noch Organisations-Admin bist
- `400 Bad Request` (`invalidRequestBody`) wenn `:id` keine positive Ganzzahl ist, oder `snoozedUntil` kein gültiger Zeitpunkt ist
- `400 Bad Request` (`imSnoozeRangeInvalid`) wenn `snoozedUntil` nicht in der Zukunft oder mehr als 7 Tage voraus liegt
- `404 Not Found` (`imIncidentNotFound`) wenn der Incident nicht existiert oder zu einer anderen Organisation gehört
- `422 Unprocessable Entity` (`imIncidentClosed`) wenn der Incident `resolved` oder `merged` ist