Skip to main content

Module api

Module api 

Source
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

MethodPathCapabilityStore method
GET/health(none)
POST/memoriesmemory:writestore_memory
GET/memories/:idmemory:readrecall_memory
DELETE/memories/:idmemory:writedelete_memory
POST/memories/searchmemory:readsearch_memories
POST/sessions/:session_id/turnssession:ingestingest_turn
GET/sessions/:session_id/turnsmemory:readsession_turns
POST/sessionssession:ingestcreate_session
GET/sessionsmemory:readlist_sessions
POST/sessions/:session_id/endsession:ingestend_session
GET/mining/queuemining:reviewlist_pending
POST/mining/queue/:id/acceptmining:reviewaccept_extraction
POST/mining/queue/:id/rejectmining:reviewreject_extraction
POST/sessions/:session_id/minemining:triggertrigger_mine (feature mining)

Enums§

ApiError
API-level error mapping to HTTP status codes.

Functions§

app
Builds the Ijima HTTP application router.