Change period, type or note
PATCH /api/hr/v1/absences/{id}
Module: HR · operationId: updateAbsence · Tag: Absences · Auth: access token (Authorization: Bearer <accessToken>)
Owners change requests; approvers change requested and approved absences.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes |
Request body
application/json (required)
endDate(string (date), required): Last day (YYYY-MM-DD), inclusivestartDate(string (date), required): First day (YYYY-MM-DD)typeId(string, required): Id of the absence typeemployeeId(string): Defaults to the callerendHalf(boolean): The last day is only the morningnote(string): Note of the employee (max length 2000)startHalf(boolean): The first day is only the afternoonversion(integer): Required for PATCH
Example:
{
"endDate": "2026-12-17",
"note": "Städtereise Wien, Rückreise am Donnerstag",
"startDate": "2026-12-14",
"typeId": "8c0e2a4c-6e8a-4c0e-9a4c-6e8a0c2e4a13",
"version": 1
}
Responses
- 200 Saved (
application/json) - 400 Error (
application/json) - 404 Error (
application/json) - 409 Error (
application/json)
Fields of the 200 answer:
createdAt(string (date-time)): When the absence was createdcreatedBy(string): Who entered the absence (e-mail of the caller; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · “)days(number): Working days (halves allowed)decidedAt(string (date-time)): When it was decided lastdecidedBy(string): Who decided last (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · “)decisionNote(string): Note of the last decision (e.g. the reason of a rejection)employeeId(string): Id of the employeeemployeeName(string): Display name of the employee (in lists)endDate(string (date)): Last day (YYYY-MM-DD), inclusiveendHalf(boolean): The last day is only the morningid(string): Id of the absencenote(string): The employee's notestartDate(string (date)): First day (YYYY-MM-DD)startHalf(boolean): The first day is only the afternoonstatus(string): State of the absence; types without approval start as approved (one ofrequested,approved,rejected,cancelled,cancellation_requested)typeId(string): Id of the absence typeupdatedAt(string (date-time)): When the absence was last changedversion(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
Example 200 answer:
{
"createdAt": "2026-11-16T08:12:00Z",
"createdBy": "sophie.huber@muster-it.example",
"days": 5,
"employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
"employeeName": "Sophie Huber",
"endDate": "2026-12-18",
"endHalf": false,
"id": "3e5a7c9e-1a3c-4e5a-8c7e-9a1c3e5a7c31",
"note": "Städtereise Wien",
"startDate": "2026-12-14",
"startHalf": false,
"status": "requested",
"typeId": "8c0e2a4c-6e8a-4c0e-9a4c-6e8a0c2e4a13",
"updatedAt": "2026-11-16T08:12:00Z",
"version": 1
}
Example request
curl -X PATCH 'https://api.mbcom.cloud/api/hr/v1/absences/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"endDate":"2026-12-17","note":"Städtereise Wien, Rückreise am Donnerstag","startDate":"2026-12-14","typeId":"8c0e2a4c-6e8a-4c0e-9a4c-6e8a0c2e4a13","version":1}'