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

Скачивание версии

GET /v1/files/:id/versions/:versionId/download

Метод Битрикс24: disk.version.get. Scope: disk.

Возвращает бинарные байты, Content-Type и Content-Disposition с именем версии. Передайте X-Api-Key и scope disk. downloadUrl из DTO ведёт на этот маршрут; извлекать креды Битрикс24 не нужно. Версия другого файла даёт 404 до скачивания.

Terminal

curl -H "X-Api-Key: YOUR_API_KEY" -o report.txt https://vibecode.bitrix24.tech/v1/files/7/versions/9/download

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