Skip to main content
POST
Search by context
This is the most powerful memory retrieval method. It answers: “What did we do last time we were in this exact situation?”

Request body

EventContext
required
Context to match against. See Types.
integer
default:"10"
Maximum number of results.
number
default:"0.6"
Minimum similarity threshold (0.01.0). Set to null to use the default.
integer
Filter by agent. Set to null to search across all agents.
integer
Filter by session. Set to null to search across all sessions.

Example request

Response

Returns an array of MemoryResponse objects (same schema as Get agent memories).
The system uses a context fingerprint (a hash of the context) to find near-identical situations instantly. Always query by context and goal — this ensures your agent doesn’t get confused by history from a different task.