## 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:

```json
{
  "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:

```json
{
  "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

```bash
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"}'
```
