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

Удалить расписание

DELETE /v1/work-schedules/:id

Удаляет своё расписание из библиотеки портала. Расписание, по которому работают серверы, удаляется только с согласием перевести их в другой режим. Восстановить удалённое расписание через API нельзя — создавайте новое при необходимости.

Параметры

Параметр В Тип Обяз. Описание
Параметрid Вpath Типstring Обяз.да ОписаниеID своего расписания. Источник — data[].id из списка расписаний
Параметрreassign Вquery Типstring Обяз.нет Описаниеtrue — согласие снять расписание с серверов перед удалением. Агент или бот перейдёт в ALWAYS, и его запомненный порог простоя сбросится. Приложение с idleSleepProtected: true перейдёт в эффективный ALWAYS и сохранит запомненный порог. Остальные приложения перейдут в IDLE со своим порогом, либо с 60 минутами, если своего нет. Любое другое значение читается как отказ

Примеры

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/work-schedules/WORK_SCHEDULE_ID?reassign=true" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/work-schedules/WORK_SCHEDULE_ID?reassign=true" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/work-schedules/${workScheduleId}?reassign=true`,
  { method: 'DELETE', headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)
if (res.status === 204) {
  console.log('Расписание удалено')
}

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

javascript 
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/work-schedules/${workScheduleId}?reassign=true`,
  {
    method: 'DELETE',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)
if (res.status === 204) {
  console.log('Расписание удалено')
}

Ответ

При успешном удалении возвращается HTTP-статус 204 No Content с пустым телом. Признак успеха — код ответа, не содержимое. Новые режимы переведённых серверов читаются в GET /v1/infra/servers/:id.

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

HTTP/1.1 204 No Content

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

409 — по расписанию работают серверы, а reassign=true не передан:

JSON 
{
  "success": false,
  "error": {
    "code": "WORK_SCHEDULE_IN_USE",
    "message": "The work schedule is assigned to servers: repeat with reassign=true to move them to another run mode and delete it",
    "details": { "assignedCount": 2 }
  }
}

Ошибки

HTTP Код Описание
HTTP400 КодRUN_MODE_UNAVAILABLE ОписаниеРежимы работы ещё не включены для портала
HTTP401 КодMISSING_API_KEY ОписаниеНе передан заголовок X-Api-Key
HTTP401 КодINVALID_API_KEY ОписаниеКлюч не опознан: такой строки на платформе нет
HTTP403 КодWORK_SCHEDULE_PRESET_READONLY ОписаниеРасписание готовое — оно не удаляется
HTTP403 КодWORK_SCHEDULE_EDIT_FORBIDDEN ОписаниеУдалить расписание может только его автор или администратор портала
HTTP403 КодWRITE_BLOCKED_READONLY_KEY ОписаниеКлюч в режиме «только чтение» — удаление ему закрыто
HTTP403 КодINFRA_SCOPE_REQUIRED ОписаниеУ ключа нет скоупа vibe:infra
HTTP403 КодINFRA_FORBIDDEN_FOR_COWORK_KEY ОписаниеВызов сделан ключом Cowork/Code — библиотека расписаний такому ключу закрыта. Что делать — Проектный ключ для деплоя
HTTP404 КодNOT_FOUND ОписаниеРасписания с таким id нет в портале ключа, либо ключ не привязан к порталу Битрикс24
HTTP409 КодWORK_SCHEDULE_IN_USE ОписаниеПо расписанию работают серверы, а reassign=true не передан. Число серверов — в error.details.assignedCount. Тот же ответ приходит, если сервер назначили на расписание во время удаления, — повторите запрос
HTTP429 КодRATE_LIMITED ОписаниеПревышен лимит 10 запросов в минуту на ключ. Действующее значение — в заголовке x-ratelimit-limit

Полный список общих ошибок API — Ошибки.

Известные особенности

  • Перевод касается и серверов других сотрудников. С reassign=true в другой режим переходят все серверы на расписании, не только принадлежащие владельцу ключа, — и вместе с режимом меняется их счёт.
  • Удалённые серверы удалению не мешают. Серверы, которые уже удалены, в assignedCount не входят и снимаются с расписания без согласия.

Смотрите также