> ## Documentation Index
> Fetch the complete documentation index at: https://api-documentation.kare-app.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Building-works

> API changes for the Building-works module.

<Update label="2026-09-14">
  **4 API change(s)**

  **`GET /rs/building-works/v1/`**

  * added the enum value `documents-stats` to the property `items/` of the `query` request parameter `extend`
  * added the optional property `data/items/documentsStats` to the response with the `200` status

  **`GET /rs/building-works/v1/{id}`**

  * added the enum value `counts` to the property `items/` of the `query` request parameter `extend`
  * added the optional property `_count` to the response with the `200` status
</Update>

<Update label="2026-09-08">
  **3 API change(s) - ⚠️ includes 3 breaking change(s)**

  **`GET /rs/building-works/v1/{id}`**

  * added the new `evacuation_plan` enum value to the `documents/items/type` response property for the response status `200`
  * added the new `fire_safety_instructions` enum value to the `documents/items/type` response property for the response status `200`
  * added the new `intervention_plan` enum value to the `documents/items/type` response property for the response status `200`
</Update>

<Update label="2026-09-07">
  **3 API change(s) - ⚠️ includes 3 breaking change(s)**

  **`GET /rs/building-works/v1/`**

  * for the `query` request parameter `whereCreatedById`, the type/format of property `items/` was specialized from `string`/\`\` to `string`/`uuid`
  * for the `query` request parameter `whereIds`, the type/format of property `items/` was specialized from `string`/\`\` to `string`/`uuid`
  * for the `query` request parameter `whereUnitIds`, the type/format of property `items/` was specialized from `string`/\`\` to `string`/`uuid`
</Update>

<Update label="2026-08-28 (#697)">
  **1 API change(s) - ⚠️ includes 1 breaking change(s)**

  **`GET /rs/building-works/v1/{id}`**

  * added the new `contract` enum value to the `documents/items/type` response property for the response status `200`
</Update>

<Update label="2026-08-28">
  **4 API change(s) - ⚠️ includes 2 breaking change(s)**

  **`POST /rs/building-works/v1/{id}/archive`**

  * api path removed without deprecation

  **`POST /rs/building-works/v1/{id}/unarchive`**

  * api path removed without deprecation

  **`POST /rs/building-works/v1/batch-archive`**

  * endpoint added

  **`POST /rs/building-works/v1/batch-unarchive`**

  * endpoint added
</Update>

<Update label="2026-08-26 (#665)">
  **3 API change(s)**

  **`GET /rs/building-works/v1/`**

  * added the required property `data/items/actions/canBeReceived` to the response with the `200` status

  **`GET /rs/building-works/v1/{id}`**

  * added the required property `actions/canBeReceived` to the response with the `200` status

  **`POST /rs/building-works/v1/{id}/receive`**

  * endpoint added
</Update>

<Update label="2026-08-26">
  **1 API change(s)**

  **`GET /rs/building-works/v1/`**

  * added the new optional `query` request parameter `countOnly`
</Update>

<Update label="2026-08-03">
  **1 API change(s) — ⚠️ includes 1 breaking change(s)**

  **`GET /rs/building-works/v1/{id}`**

  * added the new `cr` enum value to the `documents/items/type` response property for the response status `200`
</Update>

<Update label="2026-07-24">
  **1 API change(s)**

  **`GET /rs/building-works/v1/`**

  * added the new optional `query` request parameter `whereIds`
</Update>

<Update label="2026-07-22">
  **2 API change(s) — ⚠️ includes 1 breaking change(s)**

  **`GET /rs/building-works/v1/`**

  * deleted the `query` request parameter `whereUnit`
  * added the new optional `query` request parameter `whereUnitIds`
</Update>

<Update label="2026-07-17">
  **7 API change(s)**

  **`GET /rs/building-works/v1/`**

  * endpoint added

  **`POST /rs/building-works/v1/`**

  * endpoint added

  **`DELETE /rs/building-works/v1/{id}`**

  * endpoint added

  **`GET /rs/building-works/v1/{id}`**

  * endpoint added

  **`PATCH /rs/building-works/v1/{id}`**

  * endpoint added

  **`POST /rs/building-works/v1/{id}/archive`**

  * endpoint added

  **`POST /rs/building-works/v1/{id}/unarchive`**

  * endpoint added
</Update>