Skip to main content
GET
/
api
/
v2
/
agents
/
{agent_id}
/
recall
curl -X GET "http://localhost:8000/api/v2/agents/my-agent/recall?query=user%20preferences&limit=10" \
  -H "Authorization: Bearer your_api_key" \
  -H "X-Session-Token: your_session_token"

{
  "agent_id": "my-agent",
  "query": "user preferences",
  "memories": [
    {
      "id": "mem_abc123",
      "content": "Prefers email communication",
      "type": "preference",
      "confidence": 0.98,
      "created_at": "2025-03-26T09:00:00Z"
    }
  ]
}

​
Overview

Run semantic search across stored memories.

​
Authentication

  • Authorization: Bearer your_api_key
  • X-Session-Token: {session_token}

​
Path Parameters

​
agent_id
string
required
Agent identifier.

​
Body Parameters

​
query
string
required
Search text.
​
limit
integer
Result limit.
​
memory_type
string
Filter type.
curl -X GET "http://localhost:8000/api/v2/agents/my-agent/recall?query=user%20preferences&limit=10" \
  -H "Authorization: Bearer your_api_key" \
  -H "X-Session-Token: your_session_token"

{
  "agent_id": "my-agent",
  "query": "user preferences",
  "memories": [
    {
      "id": "mem_abc123",
      "content": "Prefers email communication",
      "type": "preference",
      "confidence": 0.98,
      "created_at": "2025-03-26T09:00:00Z"
    }
  ]
}

​
Response Fields

​
agent_id
string
Agent ID.
​
query
string
Input query.
​
memories
array
Matched memories.