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

Удалить окно пробуждения

DELETE /v1/infra/servers/:id/wake-schedules/:scheduleId

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

Параметры

Параметр В Тип Обяз. Описание
id path string (UUID) да ID BLACKHOLE-сервера
scheduleId path string да ID окна. Источник — data[].id из списка окон

Примеры

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/wake-schedules/SCHEDULE_ID" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/wake-schedules/SCHEDULE_ID" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/wake-schedules/${scheduleId}`,
  { method: 'DELETE', headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)
const body = await res.json()
if (body.success) console.log('Окно удалено')

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

javascript 
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/wake-schedules/${scheduleId}`,
  {
    method: 'DELETE',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)

Поля ответа

Поле Тип Описание
success boolean true при успешном удалении

В отличие от удаления записей CRM-сущностей, этот эндпоинт отвечает 200 с телом { "success": true }, а не 204 No Content.

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

JSON 
{
  "success": true
}

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

404 — окно не найдено:

JSON 
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Wake window not found"
  }
}

Ошибки

HTTP Код Описание
401 MISSING_API_KEY Не передан заголовок X-Api-Key
401 INVALID_API_KEY Неверный или просроченный API-ключ
403 INFRA_SCOPE_REQUIRED У ключа нет скоупа vibe:infra
404 NOT_FOUND Сервер не найден/удалён/принадлежит другому API-ключу, либо окно с таким scheduleId у этого сервера не найдено
429 RATE_LIMITED Превышен лимит 10 запросов в минуту на этот эндпоинт

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

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

  • Работает независимо от статуса функции для портала. В отличие от создания и обновления, удаление уже существующего окна не гейтится WAKE_SCHEDULE_DISABLED — так владелец сервера может убрать окно, даже если пробуждение по расписанию отключили на портале после его создания.
  • Не проверяет режим и статус сервера. В отличие от создания и обновления, удаление не запускает проверки BLACKHOLE_ONLY/GALAXY_NOT_SUPPORTED/ALWAYS_ON_CONFLICT — окно можно удалить у сервера в любом режиме, если оно у него есть.

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