---
title: "Updates an Incidence"
method: PUT
path: "/api/2026-10-01/resources/bookkeepers_management/incidences/{id}"
tags: ["BookkeepersManagement > Incidence"]
---

# Updates an Incidence

`PUT /api/2026-10-01/resources/bookkeepers_management/incidences/{id}`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/bookkeepers_management/incidences/{id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `employee_updates`
  - API key in header `x-api-key`

Updates an Incidence

## Path parameters

- `id` string, required

## Request body

- object
  - `id` string, required: incidence (aka employee update) identifier to update.
  - `status` string: status of the incidence (aka employee update). It can be any of 'in-preparation', 'to-do', 'doing', 'done', 'discarded'
  - `has_message` boolean: Boolean that indicates is the incidence (aka employee update) has message
  - `message_from` string
  - `read_at` string: Date in which the incidence (aka employee update) was read
  - `mark_as_read` boolean: Boolean that indicate if the incidence is read

## Response `200`

OK

- BookkeepersManagementIncidence
  - `id` string, required: identifier of the incidence (aka employee update).
  - `employee_id` string: identifier of employee related.
  - `legal_entity_id` string, required: identifier of legal entity related.
  - `name` string, required: name of the incidence (aka employee update). It also represent the incidence type. For example a new hire incidence will be
  - `custom_name` string
  - `target_id` string, required: The incidence (aka employee update) is also related to a another resource, for example for a leave target, the target identifier will be the leave id.
  - `target_type` string, required: The incidence (aka employee update) is also related to a another resource, for example a leave. This is the target type. The other types are Employee, Contracts::ContractVersion, BookkeepersManagement::ManualIncidence, Finance::CostCenterMembership.
  - `starts_on` string: The date the incidence (aka employee update) starts.
  - `ends_on` string: The date the incidence (aka employee update) end.
  - `read_at` string: The date the incidence (aka employee update) was read.
  - `status` string, required
  - `company_id` string, required: identifier of company related.
  - `message_from` string: Indicate the message sender on the incidence (aka employee update). It can be any of 'bookkeeper', 'admin'
  - `has_message` boolean: Boolean that indicates if the incidence (aka employee update) has unread messages.
  - `created_at` string, required: Date in which incidence (aka employee update) was created.
  - `is_reopened` boolean, required: Boolean that indicates if the incidence (aka employee update) has been reopened.
  - `legal_entity_name` string
  - `employee_first_name` string
  - `employee_last_name` string

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/bookkeepers_management/incidences/:id/put.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)