API: docs
GET /api/v1/docs/changelog
Section titled “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.
Auth: Authorization: Bearer <token> required
Responses:
| Code | Meaning | Body |
|---|---|---|
200 | Successful Response | CapabilityChangelog |
401 | Missing or invalid authentication credentials | ErrorResponse |
GET /api/v1/docs/file
Section titled “GET /api/v1/docs/file”Get File
: markdown content + frontmatter + resolved wikilinks.
Auth: Authorization: Bearer <token> required
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
path | query | yes | string | Relative path within vault |
Responses:
| Code | Meaning | Body |
|---|---|---|
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
Section titled “GET /api/v1/docs/tree”Get Tree
: recursive tree of.md files + dirs.
Auth: Authorization: Bearer <token> required
Responses:
| Code | Meaning | Body |
|---|---|---|
200 | Successful Response | array of TreeNode |
401 | Missing or invalid authentication credentials | ErrorResponse |