API: docs
GET /api/v1/docs/changelog
Заголовок раздела «GET /api/v1/docs/changelog»Get Changelog
Capability changelog of the agent-facing READ surface, layer C).
An external read-API agent (which sees the X-Capability-Version echo header) diffs these
entries from its last-seen version to learn which endpoints/fields/semantics changed BEFORE it
acts on stale assumptions. Mirrors the MCP changelog://entherium resource — one source
(app.discovery.CAPABILITY_CHANGELOG), so the two surfaces cannot drift.
Авторизация: нужен Authorization: Bearer <token>
Ответы:
| Код | Смысл | Тело |
|---|---|---|
200 | Successful Response | CapabilityChangelog |
401 | Missing or invalid authentication credentials | ErrorResponse |
GET /api/v1/docs/file
Заголовок раздела «GET /api/v1/docs/file»Get File
: markdown content + frontmatter + resolved wikilinks.
Авторизация: нужен Authorization: Bearer <token>
| Параметр | Где | Обязателен | Тип | Описание |
|---|---|---|---|---|
path | query | да | string | Relative path within vault |
Ответы:
| Код | Смысл | Тело |
|---|---|---|
200 | Successful Response | DocFile |
400 | Requested path is not a .md file | — |
401 | Missing or invalid authentication credentials | ErrorResponse |
403 | Path escapes the docs vault | — |
404 | File not found | — |
422 | Validation Error | HTTPValidationError |
GET /api/v1/docs/tree
Заголовок раздела «GET /api/v1/docs/tree»Get Tree
: recursive tree of.md files + dirs.
Авторизация: нужен Authorization: Bearer <token>
Ответы:
| Код | Смысл | Тело |
|---|---|---|
200 | Successful Response | массив TreeNode |
401 | Missing or invalid authentication credentials | ErrorResponse |