# Файлы

Вложения к документам Базы знаний 2.0. Файл добавляется в два шага: сначала [загрузка](./files/upload.md) сохраняет содержимое и привязывает файл к документу, затем [получение метаданных](./files/get.md) возвращает готовый фрагмент `assetMarkdown` для вставки в содержимое документа через `PATCH /v1/note/documents/:id`.

**Скоуп:** `note` | **Базовый URL:** `https://vibecode.bitrix24.tech/v1` | **Авторизация:** `X-Api-Key`

## Операции

- [Загрузить файл](./files/upload.md) — `POST /v1/note/documents/:documentId/files`
- [Получить метаданные файла](./files/get.md) — `GET /v1/note/documents/:documentId/files/:id`

## Типовой сценарий

1. Создать документ: `POST /v1/note/documents`.
2. Загрузить файл: `POST /v1/note/documents/:documentId/files` — запомнить `id` из ответа.
3. Получить фрагмент для вставки: `GET /v1/note/documents/:documentId/files/:id` — взять `assetMarkdown`.
4. Вставить фрагмент в содержимое: `PATCH /v1/note/documents/:id` с обновлённым `markdown`.

Полный пример с curl — [Обзор Базы знаний](/docs/note).

## Смотрите также

- [Базы знаний](/docs/note/collections)
- [Документы](/docs/note/documents)
- [Обзор Базы знаний](/docs/note)