> ## Documentation Index
> Fetch the complete documentation index at: https://developers.jobhandy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Vorfälle

> Meldung von Mitarbeitervorfällen, serververwalteter Lifecycle-Status, unterstützte Updates und Nachweisanhänge.

Vorfälle sind mit einem Mitarbeiter im API-Key-Scope verknüpft. Der referenzierte Mitarbeiter muss aktiviert sein, bevor ein Vorfall erstellt werden kann. Der Server setzt Meldermetadaten und Lifecycle-Status.

## Fachliche Werte

| Feld   | Werte                                              |
| ------ | -------------------------------------------------- |
| Typ    | `temporary`, `permanent`                           |
| Status | `reported`, `in_progress`, `completed`, `archived` |
| Melder | `user`, `api_key`                                  |

Der Status wird serverseitig verwaltet; die öffentliche Patch-Operation stellt dokumentierte bearbeitbare Felder bereit, aber kein frei beschreibbares Statusupdate.

## Endpoints

<CardGroup cols={2}>
  <Card title="Vorfälle auflisten" icon="list" href="/de/api-reference/incidents/list-incidents">
    Vorfälle nach Nummer, Typ, Status, Mitarbeiter, Melder und Datumsfeldern filtern und sortieren.
  </Card>

  <Card title="Vorfall erstellen" icon="triangle-alert" href="/de/api-reference/incidents/create-incident">
    Einen temporären oder permanenten Vorfall für einen autorisierten und aktivierten Mitarbeiter melden.
  </Card>

  <Card title="Vorfall abrufen" icon="file-search" href="/de/api-reference/incidents/get-incident">
    Aktuellen serververwalteten Status und Datumsfelder lesen.
  </Card>

  <Card title="Vorfall aktualisieren" icon="file-pen" href="/de/api-reference/incidents/update-incident">
    Unterstützte Typ- und Datumsfelder patchen; Vorfälle können nicht wiedereröffnet werden.
  </Card>

  <Card title="Anhänge hochladen" icon="upload" href="/de/api-reference/incidents/upload-attachments">
    Zulässige Bild- oder PDF-Nachweise zu einem bearbeitbaren abgeschlossenen Vorfall hochladen.
  </Card>
</CardGroup>

## Attachment-Grenzwerte

| Einschränkung      | Wert                         |
| ------------------ | ---------------------------- |
| Multipart-Feld     | `uploads`                    |
| Dateianzahl        | 1 bis 5                      |
| Medientypen        | `image/*`, `application/pdf` |
| Vollständiger Body | Maximal 5 MiB                |
| Dry Run            | Unterstützt                  |

<Card title="Integrationsleitfaden für Vorfälle" icon="workflow" horizontal href="/de/guides/manage-incidents">
  Prüfen Sie Lifecycle-Verantwortung, unterstützte Updates, Dateivalidierung und Kontrollen zur Datenminimierung.
</Card>