---
title: "Changes to PUT /v4/absences/{id}"
method: PUT
path: "/v4/absences/{id}"
---

# Changes to PUT /v4/absences/{id}

`PUT /v4/absences/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 28 revisions.

- **2026-10-07** `c84da07d7eb7`: 1 info
- **2026-04-19** `a88d0ed986cf`: 1 breaking, 9 warning, 2 info
- **2025-11-20** `14ad12ae7053`: 3 info

## Changes

- **2026-10-07** `c84da07d7eb7`: 1 info
  - added the new optional request property `mail_approval_token`
- **2026-04-19** `a88d0ed986cf`: 1 breaking, 9 warning, 2 info
  - removed the required property `errors/items/error/anyOf[subschema #2: Absence collision error]/details/collidingAbsences` from the response with the `422` status
  - added the new `AbsenceCollision` enum value to the `errors/items/error/anyOf[subschema #2: Absence collision error]/type` response property for the response status `422`
  - added the new `AbsenceHasToBeDeclined` enum value to the `errors/items/error/anyOf[subschema #1: Absence has to be declined error]/type` response property for the response status `422`
  - added the new `CannotManageAbsencesOfUser` enum value to the `errors/items/error/anyOf[subschema #11: Cannot manage absences of user error -> subschema #9: Cannot manage absences of user error]/type` response property for the response status `422`
  - added the new `Empty` enum value to the `errors/items/error/anyOf[subschema #3: Empty error]/type` response property for the response status `422`
  - added the new `FieldsShouldBeEmpty` enum value to the `errors/items/error/anyOf[subschema #4: Fields should be empty error]/type` response property for the response status `422`
  - added the new `HalfDayAbsenceTooLong` enum value to the `errors/items/error/anyOf[subschema #5: Half day absence too long error]/type` response property for the response status `422`
  - added the new `StatusIsForbidden` enum value to the `errors/items/error/anyOf[subschema #8: Status is forbidden error -> subschema #6: Status is forbidden error]/type` response property for the response status `422`
  - added the new `UntilBeforeSinceIsForbidden` enum value to the `errors/items/error/anyOf[subschema #10: Until before since is forbidden error -> subschema #8: Until before since is forbidden error]/type` response property for the response status `422`
  - added the new `UntilMustBeInSameYear` enum value to the `errors/items/error/anyOf[subschema #9: Until must be in same year error -> subschema #7: Until must be in same year error]/type` response property for the response status `422`
  - removed `#/components/schemas/FieldsShouldBeEmptyError, #/components/schemas/EmptyError` from the `errors/items/error` response property `anyOf` list for the response status `422`
  - added the required property `errors/items/error/anyOf[subschema #2: Absence collision error]/details/colliding_absences` to the response with the `422` status
- **2025-11-20** `14ad12ae7053`: 3 info
  - the request property `count_hours` became nullable
  - added `#/components/schemas/CannotManageAbsencesOfUserError` to the `errors/items/error` response property `anyOf` list for the response status `422`
  - removed `#/components/schemas/UserIsNotManageableError` from the `errors/items/error` response property `anyOf` list for the response status `422`

---

[Operation](https://skmtc.dev/clockodo/apis/clockodo-api-documentation/docs/v4/absences/:id/put.md) - [API](https://skmtc.dev/clockodo/apis/clockodo-api-documentation.md) - [Page](https://skmtc.dev/clockodo/apis/clockodo-api-documentation/changes/v4/absences/:id/put)