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

Отметить расписание по умолчанию

PUT /v1/work-schedules/:id/default

Отмечает расписание работы, на котором рождаются новые машины портала, или снимает эту отметку. Уже созданные машины свой режим не меняют.

Отметок две, и ставятся они независимо: machines — для новых серверов и приложений в галактике, agents — для новых агентов и ботов. Агент на расписании вне окна спит и не отвечает на сообщения до начала следующего окна, поэтому для агентов отметка отдельная. Каждая отметка стоит не больше чем на одном расписании: поставленная на новое расписание, она снимается с прежнего.

Отметку ставит и снимает только администратор портала — она меняет режим новых машин всех сотрудников, а с ним и их счёт. Право администратора проверяется по владельцу личного ключа, поэтому вызов с ключом OAuth-приложения отклоняется с 403 ADMIN_ONLY и с сессией администратора. Примеры ниже — только для личного ключа.

Параметры

Параметр	В	Тип	Обяз.	Описание
`id`	path	string	да	ID расписания — готового или своего. Источник — `data[].id` из списка расписаний

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

Поле	Тип	Обяз.	Описание
`audience`	string	да	Какая отметка: `machines` — новые серверы и приложения в галактике, `agents` — новые агенты и боты
`enabled`	boolean	да	`true` — поставить отметку на это расписание, `false` — снять её с него

Примеры

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

Terminal

curl -X PUT https://vibecode.bitrix24.tech/v1/work-schedules/WORK_SCHEDULE_ID/default \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "audience": "machines", "enabled": true }'

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

javascript

const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/work-schedules/${workScheduleId}/default`,
  {
    method: 'PUT',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ audience: 'machines', enabled: true }),
  }
)
const { data } = await res.json()
const marked = data.find(s => s.defaultForNewMachines)
console.log(`Новые машины рождаются на расписании: ${marked ? marked.name : 'не отмечено'}`)

Поля ответа

Поле	Тип	Описание
`success`	boolean	Всегда `true` при успехе
`data`	array	Вся библиотека расписаний портала после изменения: отметка могла переехать с одного расписания на другое. Форма элемента — как в списке расписаний
`data[].defaultForNewMachines`	boolean	На этом расписании рождаются новые серверы и приложения в галактике. `true` не больше чем у одного расписания
`data[].defaultForNewAgents`	boolean	На этом расписании рождаются новые агенты и боты. `true` не больше чем у одного расписания

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

Отметка для машин поставлена на расписание «Смены склада» и в ответе стоит только на нём:

JSON

{
  "success": true,
  "data": [
    {
      "id": "cmfp4qz7x00031ocg5d1a8k2m",
      "kind": "PRESET",
      "name": "Будни 9–18",
      "presetKey": "weekdays-9-18",
      "timezone": "Europe/Moscow",
      "windows": [
        { "isoDay": 1, "start": "09:00", "end": "18:00" },
        { "isoDay": 2, "start": "09:00", "end": "18:00" },
        { "isoDay": 3, "start": "09:00", "end": "18:00" },
        { "isoDay": 4, "start": "09:00", "end": "18:00" },
        { "isoDay": 5, "start": "09:00", "end": "18:00" }
      ],
      "version": 1,
      "canEdit": false,
      "assignedCount": 3,
      "defaultForNewMachines": false,
      "defaultForNewAgents": false
    },
    {
      "id": "cmfp4r0q2000a1ocg7h2k9x3d",
      "kind": "CUSTOM",
      "name": "Смены склада",
      "presetKey": null,
      "timezone": "Europe/Moscow",
      "windows": [
        { "isoDay": 1, "start": "09:00", "end": "18:00" },
        { "isoDay": 2, "start": "09:00", "end": "13:00" },
        { "isoDay": 2, "start": "14:00", "end": "24:00" }
      ],
      "version": 2,
      "canEdit": true,
      "assignedCount": 1,
      "defaultForNewMachines": true,
      "defaultForNewAgents": false
    }
  ]
}

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

403 — владелец ключа не администратор портала: