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

# Incidents

> Employee incident reporting, server-managed lifecycle state, supported updates, and evidence attachments.

Incidents are linked to an employee in the API-key scope. The referenced employee must be activated before an incident can be created. The server assigns reporter metadata and lifecycle status.

## Domain values

| Field    | Values                                             |
| -------- | -------------------------------------------------- |
| Type     | `temporary`, `permanent`                           |
| Status   | `reported`, `in_progress`, `completed`, `archived` |
| Reporter | `user`, `api_key`                                  |

Status is server-managed; the public patch operation exposes documented editable fields rather than an arbitrary status update.

## Endpoints

<CardGroup cols={2}>
  <Card title="List incidents" icon="list" href="/api-reference/incidents/list-incidents">
    Filter and sort incidents by number, type, status, employee, reporter, and dates.
  </Card>

  <Card title="Create an incident" icon="triangle-alert" href="/api-reference/incidents/create-incident">
    Report a temporary or permanent incident for an authorized, activated employee.
  </Card>

  <Card title="Get an incident" icon="file-search" href="/api-reference/incidents/get-incident">
    Read current server-managed status and dates.
  </Card>

  <Card title="Update an incident" icon="file-pen" href="/api-reference/incidents/update-incident">
    Patch supported type and date fields; incidents cannot be reopened.
  </Card>

  <Card title="Upload attachments" icon="upload" href="/api-reference/incidents/upload-attachments">
    Upload permitted image or PDF evidence to an editable completed incident.
  </Card>
</CardGroup>

## Attachment limits

| Constraint      | Value                        |
| --------------- | ---------------------------- |
| Multipart field | `uploads`                    |
| File count      | 1 to 5                       |
| Media types     | `image/*`, `application/pdf` |
| Complete body   | Maximum 5 MiB                |
| Dry run         | Supported                    |

<Card title="Incident integration guide" icon="workflow" horizontal href="/guides/manage-incidents">
  Review lifecycle ownership, supported updates, file validation, and data-minimization controls.
</Card>