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

Очистить старые версии

POST /v1/apps/:id/sources/cleanup

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

Параметры

Параметр Тип Обяз. Описание
id (path) UUID да Идентификатор приложения. Получить — GET /v1/apps.

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

Поле Тип Обяз. По умолч. Описание
keepLatest number нет 5 Сколько последних версий оставить. Целое неотрицательное число. 0 оставит только версии с тегами manual и published.

Тело можно опустить — применяется значение по умолчанию.

Примеры

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

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/apps/<APP_ID>/sources/cleanup \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keepLatest": 3 }'

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

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/apps/<APP_ID>/sources/cleanup \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "keepLatest": 3 }'

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

javascript 
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/apps/${appId}/sources/cleanup`,
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ keepLatest: 3 }),
  },
)
const { data } = await res.json()
console.log('Удалено версий:', data.deletedVersions.length)

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

javascript 
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/apps/${appId}/sources/cleanup`,
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ keepLatest: 3 }),
  },
)
const { data } = await res.json()
console.log('Удалено версий:', data.deletedVersions.length)

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе.
data.deletedVersions string[] Идентификаторы удалённых версий. Пустой массив означает, что под очистку не попала ни одна версия.

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

HTTP 200:

JSON 
{
  "success": true,
  "data": {
    "deletedVersions": ["v2", "v1"]
  }
}

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

400 — keepLatest не является целым неотрицательным числом:

JSON 
{
  "success": false,
  "error": {
    "code": "INVALID_KEEP_LATEST",
    "message": "keepLatest must be a non-negative integer"
  }
}

Ошибки

HTTP Код Описание
400 INVALID_KEEP_LATEST Значение keepLatest не является целым неотрицательным числом.
403 SOURCE_APP_ID_MISMATCH Вызов сделан ключом авторизации vibe_app_…, выписанным на другое приложение. Такой ключ обращается только к снапшотам своего приложения, даже если оба приложения создал один автор.
403 NOT_AUTHORIZED Только автор приложения, OAuth-ключ приложения или администратор портала могут управлять снапшотами.
403 INFRA_FORBIDDEN_FOR_COWORK_KEY Вызов сделан ключом Cowork/Code — такой ключ работает только с данными, изменяющие операции ему закрыты. Что делать — Проектный ключ для деплоя.
404 APP_NOT_FOUND Приложение не существует, удалено или принадлежит другому порталу.

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

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