Skip to main content
GET
/
api
/
memories
/
agent
/
{agent_id}
Get agent memories
curl --request GET \
  --url https://api.example.com/api/memories/agent/{agent_id}
{
  "id": 123,
  "agent_id": 123,
  "session_id": 123,
  "strength": 123,
  "relevance_score": 123,
  "access_count": 123,
  "formed_at": 123,
  "last_accessed": 123,
  "context_hash": 123,
  "context": {},
  "outcome": "<string>",
  "memory_type": "<string>"
}

​
Path parameters

​
agent_id
integer
required
Agent identifier (u64).

​
Query parameters

​
limit
integer
default:"10"
Maximum number of memories to return. Max: 1000.

​
Response

Returns an array of MemoryResponse objects.
​
id
integer
Memory identifier.
​
agent_id
integer
Agent that formed the memory.
​
session_id
integer
Session identifier.
​
strength
number
Memory strength (0.0–1.0).
​
relevance_score
number
Relevance score (0.0–1.0).
​
access_count
integer
Number of times the memory has been accessed.
​
formed_at
integer
Formation timestamp (nanoseconds since Unix epoch).
​
last_accessed
integer
Last access timestamp.
​
context_hash
integer
Context fingerprint.
​
context
EventContext
Full context object. See Types.
​
outcome
string
Episode outcome description.
​
memory_type
string
One of: "Episodic", "Working", "Semantic", "Negative".
[
  {
    "id": 789,
    "agent_id": 1,
    "session_id": 5001,
    "strength": 0.92,
    "relevance_score": 0.88,
    "access_count": 3,
    "formed_at": 1738425600000000000,
    "last_accessed": 1738512000000000000,
    "context_hash": 12345678901234,
    "context": { "..." : "..." },
    "outcome": "Success",
    "memory_type": "Episodic"
  }
]