Knowledge
Knowledge base folders, collections, versions, and search.
The knowledge API stores structured reference material agents can search during runs.
Item endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/knowledge | List knowledge items. |
POST | /api/v1/knowledge | Create an item. |
GET | /api/v1/knowledge/:id | Fetch one item. |
PATCH | /api/v1/knowledge/:id | Update fields; parentId reparenting rejects cycles. |
DELETE | /api/v1/knowledge/:id | Delete an item. |
GET | /api/v1/knowledge/:id/versions | List versions. |
POST | /api/v1/knowledge/:id/versions/:ver/restore | Restore a version. |
GET | /api/v1/knowledge/search | Full-text search. |
Collection endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/knowledge/collections | List collections (folders). |
POST | /api/v1/knowledge/collections | Create a collection. |
GET | /api/v1/knowledge/collections/:id/items | List items in a collection. |