Save the absence and working-time settings (hr:admin)
PUT /api/hr/v1/work-settings
Module: HR · operationId: setWorkSettings · Tag: Configuration · Auth: access token (Authorization: Bearer <accessToken>)
Request body
application/json (required)
absencesVisibleToColleagues(boolean): Colleagues see each other's absences in the team calendar and presence; off: only the caller and the people they decide forautoEndAtMidnight(boolean): A clock segment nobody clocked out of is ended at 24:00 of its day (tenant time zone) and markedautoEndedfor checking. Off for tenants whose shifts run past midnight. (defaulttrue)carryoverExpiry(string): MM-DD the previous year's vacation expires (default"03-31")defaultDayMinutes(array of integer): Target minutes Monday … Sunday without a working-time modeldefaultVacationDays(number): Vacation days per year of employees without a working-time modelfederalState(string): Bundesland code (BW, BY, …); empty = nationwide holidays onlyselfEditDays(integer): Days back employees change their own time without a reasontimeZone(string): IANA time zone of the tenant, e.g. Europe/Berlin (default"Europe/Berlin")trackingStart(string (date)): First day time accounts count
Example:
{
"absencesVisibleToColleagues": true,
"autoEndAtMidnight": true,
"carryoverExpiry": "03-31",
"defaultDayMinutes": [
480,
480,
480,
480,
480,
0,
0
],
"defaultVacationDays": 30,
"federalState": "BY",
"selfEditDays": 14,
"timeZone": "Europe/Berlin",
"trackingStart": "2026-01-01"
}
Responses
- 200 Saved (
application/json) - 400 Error (
application/json)
Fields of the 200 answer:
absencesVisibleToColleagues(boolean): Colleagues see each other's absences in the team calendar and presence; off: only the caller and the people they decide forautoEndAtMidnight(boolean): A clock segment nobody clocked out of is ended at 24:00 of its day (tenant time zone) and markedautoEndedfor checking. Off for tenants whose shifts run past midnight. (defaulttrue)carryoverExpiry(string): MM-DD the previous year's vacation expires (default"03-31")defaultDayMinutes(array of integer): Target minutes Monday … Sunday without a working-time modeldefaultVacationDays(number): Vacation days per year of employees without a working-time modelfederalState(string): Bundesland code (BW, BY, …); empty = nationwide holidays onlyselfEditDays(integer): Days back employees change their own time without a reasontimeZone(string): IANA time zone of the tenant, e.g. Europe/Berlin (default"Europe/Berlin")trackingStart(string (date)): First day time accounts count
Example 200 answer:
{
"absencesVisibleToColleagues": true,
"autoEndAtMidnight": true,
"carryoverExpiry": "03-31",
"defaultDayMinutes": [
480,
480,
480,
480,
480,
0,
0
],
"defaultVacationDays": 30,
"federalState": "BY",
"selfEditDays": 14,
"timeZone": "Europe/Berlin",
"trackingStart": "2026-01-01"
}
Example request
curl -X PUT 'https://api.mbcom.cloud/api/hr/v1/work-settings' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"absencesVisibleToColleagues":true,"autoEndAtMidnight":true,"carryoverExpiry":"03-31","defaultDayMinutes":[480,480,480,480,480,0,0],"defaultVacationDays":30,"federalState":"BY","selfEditDays":14,"timeZone":"Europe/Berlin","trackingStart":"2026-01-01"}'