ConnectCloud Developers

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 for
  • autoEndAtMidnight (boolean): A clock segment nobody clocked out of is ended at 24:00 of its day (tenant time zone) and marked autoEnded for checking. Off for tenants whose shifts run past midnight. (default true)
  • 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 model
  • defaultVacationDays (number): Vacation days per year of employees without a working-time model
  • federalState (string): Bundesland code (BW, BY, …); empty = nationwide holidays only
  • selfEditDays (integer): Days back employees change their own time without a reason
  • timeZone (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 for
  • autoEndAtMidnight (boolean): A clock segment nobody clocked out of is ended at 24:00 of its day (tenant time zone) and marked autoEnded for checking. Off for tenants whose shifts run past midnight. (default true)
  • 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 model
  • defaultVacationDays (number): Vacation days per year of employees without a working-time model
  • federalState (string): Bundesland code (BW, BY, …); empty = nationwide holidays only
  • selfEditDays (integer): Days back employees change their own time without a reason
  • timeZone (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"}'

View as Markdown · Interactive reference · OpenAPI