Skip to main content
The Engine has three memory stores — episodes, knowledge, and the social graph — plus a “soul” representing the user’s core identity and learned patterns. Memory updates as the agent runs; these endpoints let you read and move it. All memory endpoints require X-Engine-Key.

​
POST /memory/knowledge/search

Search the knowledge store with hybrid (vector + keyword) scoring.
Response is an array of knowledge facts:

​
POST /memory/episodes/search

Same shape as knowledge search. Returns episodes — past events, conversations, outcomes.

​
POST /memory/social/search

Search the social graph (people, relationships).

​
GET /memory/soul

Get a summary of the soul.

​
GET /memory/soul/full

Same as /memory/soul but with all metadata and history. Larger payload.

​
GET /memory/export

Export the entire memory as a portable JSON bundle. Useful for backup or migration to a new Engine instance. Response is an opaque JSON blob — pass it back to /memory/import to restore.

​
POST /memory/import

Import a memory bundle previously produced by /memory/export.
Response indicates success and counts of imported records.

​
See also