# Documents

Knowledge Base 2.0 documents are pages with Markdown content, organized into a tree inside a knowledge base. This section collects the operations for creating, reading, updating, archiving, deleting, and full-text searching documents.

**Scope:** `note` | **Base URL:** `https://vibecode.bitrix24.com/v1` | **Authorization:** `X-Api-Key`

## Operations

- [Move a document subtree](./documents/move.md) — `POST /v1/note/documents/:id/move`
- [Create a document](./documents/create.md) — `POST /v1/note/documents`
- [List documents](./documents/list.md) — `GET /v1/note/documents`
- [Get a document](./documents/get.md) — `GET /v1/note/documents/:id`
- [Update a document](./documents/update.md) — `PATCH /v1/note/documents/:id`
- [Archive a document](./documents/archive.md) — `POST /v1/note/documents/:id/archive`
- [Delete a document](./documents/delete.md) — `DELETE /v1/note/documents/:id`
- [Search documents](./documents/search.md) — `GET /v1/note/documents/search`

The [Document tree](./collections/tree.md) returns the nested structure of one knowledge base; use the document list to traverse all accessible articles page by page.

Document search also accepts `POST /v1/note/documents/search` with a JSON body `{ "query": "...", "limit": 20, "offset": 20 }` — an alias for agents that expect search to be a POST request. The canonical form is GET with query parameters, and when a parameter is passed in both forms the body wins.

## See also

- [Knowledge bases](/docs/note/collections)
- [Files](/docs/note/files)
- [Knowledge Base overview](/docs/note)