# Time-control settings

Time-control settings shared by all employees of the Bitrix24 account: whether time control is on, who is asked for an absence report, and who can access monthly reports.

**Scope:** `timeman` | **Base URL:** `https://vibecode.bitrix24.com/v1` | **Authorization:** `X-Api-Key`

## Operations

- [Get time-control settings](./time-control-settings-list.md) — `GET /v1/workday/time-control/settings`
- [Update time-control settings](./time-control-settings-update.md) — `PATCH /v1/workday/time-control/settings`

## Access

Permissions are checked for the credential owner: for a personal key, this is the key owner; for an app key, the user whose session token is passed in `Authorization`. A Bitrix24 account administrator can read and change the settings; an employee without administrator rights gets `403 BITRIX_ACCESS_DENIED`. The Bitrix24 application behind the app key needs only the `timeman` permission. A `READONLY` key can read the settings but cannot change them.

## Typical scenario

1. Read the current settings: [Get time-control settings](./time-control-settings-list.md).
2. Pass only the fields you need to change: [Update time-control settings](./time-control-settings-update.md). The response contains all settings after the write.

## See also

- [Get time-control report settings](/docs/workday/time-control-report-settings)
- [Get the monthly absence report](/docs/workday/time-control-reports)
- [Explain an absence](/docs/workday/time-control-explain)
- [Workday](/docs/workday)