История версий файла

GET /v1/files/:id/versions

Метод Битрикс24: disk.file.getVersions. Scope: disk.

Новые версии идут первыми. История может быть неполной: загрузки одного автора в течение примерно пяти минут склеиваются, а настройки Битрикс24 ограничивают число версий и срок хранения. На тестовом стенде 07.10.2026 хранились три версии. Доступ только через вложение задачи или чата здесь не признаётся, хотя чтение самого файла может работать. История недоступна на некоторых тарифах: 403 DISK_HISTORY_UNAVAILABLE.

Параметры: limit 1..50 (по умолчанию 50), offset целое >=0 (по умолчанию 0). Фильтр только по id, size, name, createdAt, createdBy; синтаксис операторов entity-system: $gt, $gte, $lt, $lte, $ne, $contains, $in, $nin, префиксы >, >=, <, <=, !, %. Неизвестное поле или фильтр не объектом даёт 400 INVALID_PARAMS. Используйте bracket-форму query.

curl -H "X-Api-Key: YOUR_API_KEY" https://vibecode.bitrix24.tech/v1/files/7/versions\
  --get --data-urlencode 'filter[size][$gte]=1'

{
  "success": true,
  "data": [
    {
      "id": 9,
      "fileId": 7,
      "size": 3,
      "name": "report.txt",
      "contentGeneration": 2,
      "createdAt": "2026-10-07T07:00:00.000Z",
      "createdBy": 1,
      "downloadUrl": "/v1/files/7/versions/9/download"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 50,
    "offset": 0,
    "hasMore": false,
    "nextOffset": null
  }
}

Ошибки: 400 неверный id или параметры, 401 ключ отсутствует, 403 нет scope disk или прав Б24, 404 запись отсутствует, 422 бизнес-отказ Б24. READONLY-ключ читает, но не загружает и не восстанавливает. На записи 502 DISK_OUTCOME_UNKNOWN требует перечитать файл перед повтором.