Skip to main content
POST
/
api
/
v1
/
memory
/
recall
Recall Memory
curl --request POST \
  --url https://api.example.com/api/v1/memory/recall

​
Request Body

{
  "query": "Acme renewal",
  "agent_id": "agent_records",
  "limit": 10
}
This endpoint performs explicit archival recall. It is separate from prompt-time memory policy: archival memory is not included in agent prompts by default unless the run opts into automatic recall with memory_policy.archival_mode="auto", which injects bounded matches as hidden current-turn system_reminders. Set agent_id to search both user-wide archival memory and the agent-scoped archive. Use an empty query to list all stored archival lines for the selected scope, bounded by limit.

​
Response

[
  {
    "content": "- Acme renewal: CFO wants pricing options before May 12",
    "score": 1.72,
    "block_type": "archival",
    "scope": "user",
    "agent_id": null,
    "line_number": 4,
    "updated_at": "2026-04-30T16:30:00"
  }
]