Expand description
HTTP/JSON API surface — the REST endpoints harnesses speak.
Maps the core Store trait methods onto axum routes, each guarded
by a Schubert capability check via AuthPrincipal. Every request
is scoped to the authenticated principal’s personal namespace
(ns_<principal>_private); shared/global namespaces land with the
memory_promote endpoint.
§Routes
| Method | Path | Capability | Store method |
|---|---|---|---|
| GET | /health | (none) | — |
| POST | /memories | memory:write | store_memory |
| GET | /memories/:id | memory:read | recall_memory |
| DELETE | /memories/:id | memory:write | delete_memory |
| POST | /memories/search | memory:read | search_memories |
| POST | /sessions/:session_id/turns | session:ingest | ingest_turn |
| GET | /sessions/:session_id/turns | memory:read | session_turns |
| POST | /sessions | session:ingest | create_session |
| GET | /sessions | memory:read | list_sessions |
| POST | /sessions/:session_id/end | session:ingest | end_session |
| GET | /mining/queue | mining:review | list_pending |
| POST | /mining/queue/:id/accept | mining:review | accept_extraction |
| POST | /mining/queue/:id/reject | mining:review | reject_extraction |
| POST | /sessions/:session_id/mine | mining:trigger | trigger_mine (feature mining) |
Enums§
- ApiError
- API-level error mapping to HTTP status codes.
Functions§
- app
- Builds the Ijima HTTP application router.