# Файлы

> REST API раздела «Файлы»: 21 операция.

Базовый адрес: `https://api.legalstack.ru`. Спецификация: [openapi/files.json](https://docs.legalstack.ru/openapi/files.json).

- [Управление файлами](https://docs.legalstack.ru/api/files/files): Единые операции над файлами (шаблоны, реестры, папки, базы знаний, автоматизации, формы, проверки).
- [Хранилище](https://docs.legalstack.ru/api/files/files-blobs): Хранилище файлов: загрузка, скачивание, хранение без права изменения (WORM).
- [Папки](https://docs.legalstack.ru/api/files/files-folders): Папки для всех типов файлов в едином дереве.
- [Архив](https://docs.legalstack.ru/api/files/files-shelf): Архив: умные папки, подборки опечатанных экземпляров и личный порядок режимов.

## Операции

Всего операций: 21. У каждой операции своя страница со схемами запроса и ответа и примерами вызова.

### [Управление файлами](https://docs.legalstack.ru/api/files/files)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/files/files` | [Список файлов (фильтры kind и folderId)](https://docs.legalstack.ru/api/files/files/get-files-files) |
| `POST` | `/api/v1/files/files` | [Создать файл](https://docs.legalstack.ru/api/files/files/post-files-files) |
| `DELETE` | `/api/v1/files/files/{fileId}` | [Удалить файл](https://docs.legalstack.ru/api/files/files/delete-files-files-fileid) |
| `GET` | `/api/v1/files/files/{fileId}` | [Получить файл](https://docs.legalstack.ru/api/files/files/get-files-files-fileid) |
| `PATCH` | `/api/v1/files/files/{fileId}` | [Обновить файл](https://docs.legalstack.ru/api/files/files/patch-files-files-fileid) |
| `POST` | `/api/v1/files/files/{fileId}/move` | [Переместить файл](https://docs.legalstack.ru/api/files/files/post-files-files-fileid-move) |

### [Хранилище](https://docs.legalstack.ru/api/files/files-blobs)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/files/blobs` | [Список файлов хранилища команды (фильтры kind и folderId)](https://docs.legalstack.ru/api/files/files-blobs/get-files-blobs) |
| `DELETE` | `/api/v1/files/blobs/{fileId}` | [Удалить файл хранилища (мягкое удаление; файлы на сроке хранения удалить нельзя)](https://docs.legalstack.ru/api/files/files-blobs/delete-files-blobs-fileid) |
| `GET` | `/api/v1/files/blobs/{fileId}` | [Метаданные файла хранилища](https://docs.legalstack.ru/api/files/files-blobs/get-files-blobs-fileid) |
| `GET` | `/api/v1/files/blobs/{fileId}/download` | [Скачать файл из хранилища](https://docs.legalstack.ru/api/files/files-blobs/get-files-blobs-fileid-download) |

### [Папки](https://docs.legalstack.ru/api/files/files-folders)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/files/folders` | [Список папок](https://docs.legalstack.ru/api/files/files-folders/get-files-folders) |
| `POST` | `/api/v1/files/folders` | [Создать папку](https://docs.legalstack.ru/api/files/files-folders/post-files-folders) |
| `DELETE` | `/api/v1/files/folders/{folderId}` | [Удалить папку](https://docs.legalstack.ru/api/files/files-folders/delete-files-folders-folderid) |
| `PATCH` | `/api/v1/files/folders/{folderId}` | [Обновить папку](https://docs.legalstack.ru/api/files/files-folders/patch-files-folders-folderid) |
| `GET` | `/api/v1/files/folders/{folderId}/children` | [Содержимое папки](https://docs.legalstack.ru/api/files/files-folders/get-files-folders-folderid-children) |

### [Архив](https://docs.legalstack.ru/api/files/files-shelf)

| Метод | Путь | Операция |
| --- | --- | --- |
| `POST` | `/api/v1/files/shelf/folders` | [Создать папку архива — умную (по правилу) или подборку](https://docs.legalstack.ru/api/files/files-shelf/post-files-shelf-folders) |
| `DELETE` | `/api/v1/files/shelf/folders/{folderId}` | [Удалить папку архива; файлы остаются в архиве](https://docs.legalstack.ru/api/files/files-shelf/delete-files-shelf-folders-folderid) |
| `PATCH` | `/api/v1/files/shelf/folders/{folderId}` | [Изменить папку архива](https://docs.legalstack.ru/api/files/files-shelf/patch-files-shelf-folders-folderid) |
| `POST` | `/api/v1/files/shelf/folders/{folderId}/files` | [Добавить файлы архива в подборку](https://docs.legalstack.ru/api/files/files-shelf/post-files-shelf-folders-folderid-files) |
| `DELETE` | `/api/v1/files/shelf/folders/{folderId}/files/{fileId}` | [Убрать файл из подборки; сам файл остаётся в архиве](https://docs.legalstack.ru/api/files/files-shelf/delete-files-shelf-folders-folderid-files-fileid) |
| `PUT` | `/api/v1/files/shelf/preferences` | [Сохранить личный порядок и видимость режимов архива](https://docs.legalstack.ru/api/files/files-shelf/put-files-shelf-preferences) |