curl -X POST "http://localhost:8000/api/v2/agents/my-agent/recall/as-of" \
-H "X-Session-Token: your_session_token" \
-H "Content-Type: application/json" \
-d '{
"as_of": "2026-05-01T12:00:00Z",
"limit": 10
}'
curl -X POST "http://localhost:8000/api/v2/agents/my-agent/recall/as-of" \
-H "X-Session-Token: your_session_token" \
-H "Content-Type: application/json" \
-d '{
"as_of": "2026-05-01",
"type": ["fact", "decision"]
}'
{
"agent_id": "my-agent",
"session_id": "sess_123abc",
"as_of_date": "2026-05-01T12:00:00+00:00",
"memories": [
{
"id": "3e681f12-a28c-4d1d-9632-b8dadf1f9d0c",
"title": "Primary OLTP Database",
"content": "We use PostgreSQL for OLTP workloads.",
"text": "[FACT] Primary OLTP Database\n\nWe use PostgreSQL for OLTP workloads.",
"type": "fact",
"confidence": 0.9,
"status": "active",
"expired_at": null,
"expired_by": null,
"tags": [],
"created_at": "2026-04-28T18:47:46Z",
"updated_at": "2026-04-28T18:47:46Z",
"actor_id": "my-agent",
"source": "agent",
"source_ref": null,
"agent_id": "my-agent",
"score": null,
"provenance": "explicit_statement"
}
],
"count": 1,
"temporal_mode": "as_of"
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
{
"detail": [
{
"type": "missing",
"loc": ["body", "as_of"],
"msg": "Field required",
"input": {}
}
]
}
{
"detail": [
{
"type": "value_error",
"loc": ["body", "as_of"],
"msg": "Value error, Invalid value '2026-13-40'. Use YYYY-MM-DD or ISO 8601 datetime.",
"input": "2026-13-40"
}
]
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
}
}
}
Search & Discovery
Recall As Of
Point-in-time recall — return memories as they existed at a specified historical timestamp.
POST
/
api
/
v2
/
agents
/
{agent_id}
/
recall
/
as-of
curl -X POST "http://localhost:8000/api/v2/agents/my-agent/recall/as-of" \
-H "X-Session-Token: your_session_token" \
-H "Content-Type: application/json" \
-d '{
"as_of": "2026-05-01T12:00:00Z",
"limit": 10
}'
curl -X POST "http://localhost:8000/api/v2/agents/my-agent/recall/as-of" \
-H "X-Session-Token: your_session_token" \
-H "Content-Type: application/json" \
-d '{
"as_of": "2026-05-01",
"type": ["fact", "decision"]
}'
{
"agent_id": "my-agent",
"session_id": "sess_123abc",
"as_of_date": "2026-05-01T12:00:00+00:00",
"memories": [
{
"id": "3e681f12-a28c-4d1d-9632-b8dadf1f9d0c",
"title": "Primary OLTP Database",
"content": "We use PostgreSQL for OLTP workloads.",
"text": "[FACT] Primary OLTP Database\n\nWe use PostgreSQL for OLTP workloads.",
"type": "fact",
"confidence": 0.9,
"status": "active",
"expired_at": null,
"expired_by": null,
"tags": [],
"created_at": "2026-04-28T18:47:46Z",
"updated_at": "2026-04-28T18:47:46Z",
"actor_id": "my-agent",
"source": "agent",
"source_ref": null,
"agent_id": "my-agent",
"score": null,
"provenance": "explicit_statement"
}
],
"count": 1,
"temporal_mode": "as_of"
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
{
"detail": [
{
"type": "missing",
"loc": ["body", "as_of"],
"msg": "Field required",
"input": {}
}
]
}
{
"detail": [
{
"type": "value_error",
"loc": ["body", "as_of"],
"msg": "Value error, Invalid value '2026-13-40'. Use YYYY-MM-DD or ISO 8601 datetime.",
"input": "2026-13-40"
}
]
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
}
}
}
Overview
Returns memories that were valid at the specified point in time, excluding memories created afteras_of or expired before it. Useful for reconstructing what the agent “knew” at a given moment.
This endpoint lists memories chronologically — there is no query parameter. For semantic search, use Recall instead.
Authentication
API clients do not send an API key orAuthorization header.
string
required
Session token from Activate Agent. Must match
agent_id.string
required
Must be
application/jsonPath Parameters
string
required
The unique identifier of the agent.
Body
string
required
Point-in-time boundary. Accepts
YYYY-MM-DD (interpreted as end of day UTC) or a full ISO 8601 datetime, e.g. 2026-05-01T14:30:00Z.integer
Maximum number of results to return. Range
1–100. If omitted, the server default applies.array
Optional list of memory type filters (e.g.
["fact", "decision"]).Point-in-time recall is unaffected by the lifecycle filter. A memory that was live
at
as_of is returned with status: "active" even if it has expired since, while
one that had already expired by then is excluded. See
Memory Lifecycle.curl -X POST "http://localhost:8000/api/v2/agents/my-agent/recall/as-of" \
-H "X-Session-Token: your_session_token" \
-H "Content-Type: application/json" \
-d '{
"as_of": "2026-05-01T12:00:00Z",
"limit": 10
}'
curl -X POST "http://localhost:8000/api/v2/agents/my-agent/recall/as-of" \
-H "X-Session-Token: your_session_token" \
-H "Content-Type: application/json" \
-d '{
"as_of": "2026-05-01",
"type": ["fact", "decision"]
}'
{
"agent_id": "my-agent",
"session_id": "sess_123abc",
"as_of_date": "2026-05-01T12:00:00+00:00",
"memories": [
{
"id": "3e681f12-a28c-4d1d-9632-b8dadf1f9d0c",
"title": "Primary OLTP Database",
"content": "We use PostgreSQL for OLTP workloads.",
"text": "[FACT] Primary OLTP Database\n\nWe use PostgreSQL for OLTP workloads.",
"type": "fact",
"confidence": 0.9,
"status": "active",
"expired_at": null,
"expired_by": null,
"tags": [],
"created_at": "2026-04-28T18:47:46Z",
"updated_at": "2026-04-28T18:47:46Z",
"actor_id": "my-agent",
"source": "agent",
"source_ref": null,
"agent_id": "my-agent",
"score": null,
"provenance": "explicit_statement"
}
],
"count": 1,
"temporal_mode": "as_of"
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
{
"detail": [
{
"type": "missing",
"loc": ["body", "as_of"],
"msg": "Field required",
"input": {}
}
]
}
{
"detail": [
{
"type": "value_error",
"loc": ["body", "as_of"],
"msg": "Value error, Invalid value '2026-13-40'. Use YYYY-MM-DD or ISO 8601 datetime.",
"input": "2026-13-40"
}
]
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
}
}
}
Next Steps
- Recall Changed Since to find modifications after a specific date
- Recall for standard semantic search