Для AI-агентов: markdown этой страницы — /docs-content/workday/pause.md индекс документации — /llms.txt

Поставить на паузу

POST /v1/workday/pause

Приостанавливает текущий рабочий день. Статус переходит в PAUSED, длительность паузы накапливается до возобновления или закрытия дня. Тело запроса может быть пустым.

Поля запроса (body)

Поле	Тип	Обяз.	Описание
`userId`	number	нет	Идентификатор сотрудника. По умолчанию — пользователь, которому принадлежат токены ключа. Чужие `userId` доступны только администраторам портала и непосредственным руководителям сотрудника. Без этих прав Битрикс24 данные сотрудника не отдаёт

Тело может быть пустым: {}.

Примеры

curl — личный ключ

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/workday/pause \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

curl — OAuth-приложение

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/workday/pause \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

JavaScript — личный ключ

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/pause', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
const { data } = await res.json()
console.log('Статус:', data.status)

JavaScript — OAuth-приложение

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/pause', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
const { data } = await res.json()

Поля ответа

Поле	Тип	Описание
`success`	boolean	`true` при успешной постановке на паузу
`data`	object	Рабочий день после постановки на паузу
`data.status`	string	Статус после паузы — `PAUSED`
`data.id`	number	Идентификатор записи рабочего дня. Те же значения приходят в истории рабочих дней
`data.timeStart`	string	Дата и время начала дня (ISO 8601)
`data.timeFinish`	string \| null	Дата и время завершения дня. `null`, пока день не закрыт, в том числе на паузе
`data.duration`	string	Длительность дня без учёта пауз в формате `HH:MM:SS`. До закрытия дня — `00:00:00`
`data.timeLeaks`	string	Суммарная длительность пауз за день в формате `HH:MM:SS`. Текущая пауза входит в сумму после возобновления или закрытия дня
`data.active`	boolean	Признак активной записи рабочего дня
`data.ipOpen`	string	IP-адрес начала дня
`data.ipClose`	string	IP-адрес завершения дня. Пустая строка для дня, который ещё не был закрыт
`data.latOpen`	number	Географическая широта точки начала
`data.lonOpen`	number	Географическая долгота точки начала
`data.latClose`	number	Географическая широта точки завершения
`data.lonClose`	number	Географическая долгота точки завершения
`data.tzOffset`	number	Смещение часового пояса сотрудника в секундах. Зависит от настроек сотрудника на портале, значение `10800` соответствует UTC+3

Пример ответа

JSON

{
  "success": true,
  "data": {
    "status": "PAUSED",
    "id": 1,
    "timeStart": "2026-05-05T09:00:00+03:00",
    "timeFinish": null,
    "duration": "00:00:00",
    "timeLeaks": "00:00:00",
    "active": true,
    "ipOpen": "203.0.113.10",
    "ipClose": "",
    "latOpen": 0,
    "lonOpen": 0,
    "latClose": 0,
    "lonClose": 0,
    "tzOffset": 10800
  }
}

Пример ответа при ошибке

403 — у ключа нет скоупа timeman: