Dienst eines Vorfalls setzen

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

Setzt den betroffenen Dienst 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.

AuthentifizierungAnkerlink kopieren

Jede IM-berechtigte Rolle oder ein organisationsweites API-Token, siehe Authentifizierung. Sie müssen Mitglied im Team des Vorfalls oder admin der Organisation sein.

Request-BodyAnkerlink kopieren

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

AntwortAnkerlink kopieren

200 OK: die geänderte Vorfall-Zeile (dieselbe Form wie die items von Vorfälle auflisten, ohne die Anreicherungsfelder), mit gesetztem serviceId.

Häufige FehlerAnkerlink kopieren

• 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