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

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

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

## Параметры

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

## Примеры

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

```bash
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-приложение

```bash
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 — [Ошибки](/docs/errors).

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

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

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

- [Список окон](./list.md)
- [Создать окно](./create.md)
- [Обновить окно](./update.md)