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

Удалить сервер

DELETE /v1/infra/servers/:id

Удаляет сервер безвозвратно: виртуальная машина уничтожается у провайдера, запись в базе помечается как DELETED, открытые биллинг-транзакции финализируются. Работавший на сервере AI-агент удаляется вместе с ним. Восстановить удалённый сервер нельзя — создавайте новый через POST /v1/infra/servers. Удаление идемпотентно только на уровне виртуальной машины у провайдера (если она уже удалена у провайдера, ошибки не будет). Повторный вызов для уже помеченного сервера вернёт 404.

Параметры

Параметр	В	Тип	Обяз.	Описание
`id`	path	string (UUID)	да	ID сервера из `POST /v1/infra/servers` или `GET /v1/infra/servers`

Примеры

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

Terminal

curl -X DELETE -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/infra/servers/db008c84-91a5-4e15-b9d5-6c6aa2838448

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

Terminal

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

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

javascript

const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}`,
  {
    method: 'DELETE',
    headers: { 'X-Api-Key': 'YOUR_API_KEY' },
  }
)
const { success } = await res.json()
if (success) console.log('Сервер удалён')

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

javascript

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

Поля ответа

Поле	Тип	Описание
`success`	boolean	`true` — запись сервера удалена, начисления за него остановлены
`cloudDelete`	string	Чем закончился запрос на удаление виртуальной машины в облаке — см. ниже

Значения cloudDelete:

confirmed — облако приняло запрос на удаление машины.
already-gone — машины в облаке уже не было.
failed — облако запрос не приняло. Запись сервера удалена и начисления остановлены, но машина может продолжать работать. Не считайте ресурс уничтоженным. Повтор запроса вернёт 404 — записи сервера уже нет.
not-applicable — у сервера нет виртуальной машины в облаке, например у galaxy-приложения.

confirmed и already-gone для клиента равнозначны: машина удалена или удаляется. success равен true при любом значении cloudDelete.

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

JSON

{
  "success": true,
  "cloudDelete": "confirmed"
}

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

404 — сервер уже удалён или не существует: