# Документы

Документы Базы знаний 2.0 — страницы с содержимым в Markdown, организованные в дерево внутри базы знаний. Здесь собраны операции создания, чтения, обновления, архивирования, удаления и полнотекстового поиска документов.

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

## Операции

- [Создать документ](./documents/create.md) — `POST /v1/note/documents`
- [Получить документ](./documents/get.md) — `GET /v1/note/documents/:id`
- [Обновить документ](./documents/update.md) — `PATCH /v1/note/documents/:id`
- [Архивировать документ](./documents/archive.md) — `POST /v1/note/documents/:id/archive`
- [Удалить документ](./documents/delete.md) — `DELETE /v1/note/documents/:id`
- [Поиск документов](./documents/search.md) — `GET /v1/note/documents/search`

Список документов одной базы знаний возвращает [Дерево документов](./collections/tree.md) — `GET /v1/note/collections/:collectionId/documents`.

Поиск документов принимает и `POST /v1/note/documents/search` с JSON-телом `{ "query": "...", "limit": 20 }` — алиас для агентов, ожидающих поиск POST-запросом. Каноническая форма — GET с query-параметрами, при передаче параметра в обеих формах приоритет у тела.

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

- [Базы знаний](/docs/note/collections)
- [Файлы](/docs/note/files)
- [Обзор Базы знаний](/docs/note)