Docs · LLMs and developers
Reviewed2026-07-07Version3.12.1Memory API
Source-aligned map of the Achiral memory API surfaces.
The Memory API is a cluster of implementation-backed surfaces for memory-augmented inference, signed-in workspace memory views, candidate review, knowledge memory, reflection, preference calibration, and habit controls.
Achiral does not currently expose separate public endpoints for procedural, episodic, semantic, flashbulb, or core memory. Those memory types appear in aggregate responses, candidate review flows, and product behavior.
Authentication
| Surface | Auth | Scope |
|---|---|---|
/v1/* inference gateway | Bearer MCP access token such as acm_... | Token must include inference:chat |
/api/user/memory/* | Signed-in workspace session | Current user in the current organization |
/api/assistants/:id/memory/* | Signed-in workspace session | Assistant access and memory permissions |
/api/organizations/:id/memory/* | Signed-in workspace session | Organization owner or admin |
/api/memory/* | Signed-in workspace session | Memory permissions required by route |
API surfaces
- Inference gateway: OpenAI-compatible
/v1chat completions for memory-augmented inference. - User memory: signed-in account memory summary and personal memory candidate review.
- Assistant memory: assistant memory summary and assistant-scoped candidate review.
- Organization memory: organization memory distribution, member summaries, and organization candidate review.
- Core memory candidates: approve or reject flashbulb candidates before they become durable core memory.
- Knowledge memory: create, search, update, and delete organization knowledge records.
- Reflection loop: configure, inspect, and run reflection over memory.
- Preference calibration: feedback and calibration routes for learned preferences.
- Habit memory API: personal controls for Chiro's habit behavior.
Continue from here
- API reference for shared API conventions, base URLs, streaming, and errors.
- ACT-R memory for the product model behind activation, retrieval, decay, and consolidation.