# Восстановление содержимого из версии

`POST /v1/files/:id/versions/:versionId/restore`

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

Создаёт НОВУЮ версию с содержимым выбранной, а не перематывает историю. Каждый вызов добавляет ещё одну версию. Лимит хранения может вытеснить самую старую, включая версию-источник. Принадлежность проверяется до записи. Тарифный отказ истории: 403 DISK_HISTORY_UNAVAILABLE. Не повторяйте запрос автоматически после таймаута: исход неизвестен, перечитайте файл.

```bash
curl -X POST -H "X-Api-Key: YOUR_API_KEY" https://vibecode.bitrix24.tech/v1/files/7/versions/9/restore
```

Ответ: проекция files и `meta.newVersionId` — первая версия истории после вызова, либо null при недоступной истории.

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