Skip to main content
POST /v1/memory/recall

​
Request body

FieldTypeRequiredDescription
user_idstring✅User to recall memory for
querystring✅The query to find relevant memories for
app_idstringFilter to a specific application
workspace_idstringFilter to a specific workspace or team
agent_idstringFilter to a specific agent
top_kintegerMax number of memory paths (default: 5)

​
Example

curl -X POST http://localhost:8000/v1/memory/recall \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "alice",
    "app_id": "app_a",
    "workspace_id": "team_1",
    "query": "How should I format my answers?",
    "top_k": 5
  }'

​
Response

{
  "context": "alice prefers dark mode and short answers.",
  "paths": 2,
  "knowledge": []
}