---
title: "Dienst eines Vorfalls setzen"
description: "Nennt den Dienst, den ein Incident-Management-Vorfall betrifft, oder nimmt ihn weg."
---

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

Setzt den betroffenen [Dienst](/de/api/incident-management/services) eines Vorfalls von Hand oder nimmt ihn mit `null` weg. Erlaubt in jedem Status, auch nach dem Lösen. Rein beschreibend: niemand wird alarmiert, keine Statusseite und keine Outbound-Integration erfährt davon. Die Änderung steht in der Timeline des Vorfalls (`service_changed`, Payload `{ from, to }` mit `{ id, name }` oder `null`) und im Audit-Protokoll der Organisation. Ein Aufruf ohne Änderung schreibt nichts.

## Authentifizierung

Jede IM-berechtigte Rolle oder ein organisationsweites API-Token, siehe [Authentifizierung](/de/api/incident-management#authentifizierung). Sie müssen Mitglied im Team des Vorfalls oder `admin` der Organisation sein.

## Request-Body

| Feld | Typ | Pflicht | Beschreibung |
|------|-----|---------|--------------|
| `serviceId` | integer \| string \| null | Ja | `id` oder `publicId` eines Dienstes der Organisation des Vorfalls; `null` nimmt den Dienst weg. |

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

## Antwort

`200 OK`: die geänderte Vorfall-Zeile (dieselbe Form wie die `items` von [Vorfälle auflisten](/de/api/incident-management/list-incidents), ohne die Anreicherungsfelder), mit gesetztem `serviceId`.

## Häufige Fehler

- `401 Unauthorized` ohne Anmeldung
- `403 Forbidden` (`imTeamMembershipRequired`) wenn Sie weder Mitglied im Team des Vorfalls noch `admin` der Organisation sind
- `400 Bad Request` (`invalidRequestBody`) wenn `serviceId` fehlt oder weder Ganzzahl, UUID noch `null` ist
- `404 Not Found` (`imIncidentNotFound`) wenn es den Vorfall nicht gibt oder er einer anderen Organisation gehört
- `404 Not Found` (`imServiceNotFound`) wenn es den Dienst nicht gibt oder er einer anderen Organisation gehört