Skip to main content
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
  }'

{
  "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",
      "tags": [],
      "created_at": "2026-04-28T18:47:46Z",
      "updated_at": "2026-04-28T18:47:46Z",
      "actor_id": "my-agent",
      "source": "agent",
      "scope_type": "agent",
      "scope_id": "my-agent",
      "score": null,
      "provenance": "explicit_statement",
      "validation_count": 0,
      "contradiction_detected": false
    }
  ],
  "count": 1,
  "temporal_mode": "as_of"
}

​
Overview

Returns memories that were valid at the specified point in time, excluding memories created after as_of, superseded before it, 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 or Authorization header.
​
X-Session-Token
string
required
Session token from Activate Agent. Must match agent_id.
​
Content-Type
string
required
Must be application/json

​
Path Parameters

​
agent_id
string
required
The unique identifier of the agent.

​
Body

​
as_of
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.
​
limit
integer
Maximum number of results to return. Range 1–100. If omitted, the server default applies.
​
type
array
Optional list of memory type filters (e.g. ["fact", "decision"]).
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
  }'

{
  "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",
      "tags": [],
      "created_at": "2026-04-28T18:47:46Z",
      "updated_at": "2026-04-28T18:47:46Z",
      "actor_id": "my-agent",
      "source": "agent",
      "scope_type": "agent",
      "scope_id": "my-agent",
      "score": null,
      "provenance": "explicit_statement",
      "validation_count": 0,
      "contradiction_detected": false
    }
  ],
  "count": 1,
  "temporal_mode": "as_of"
}

​
Next Steps