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

`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.

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

```json
{
  "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 требует перечитать файл перед повтором.