Skip to main content
POST

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.
string
required
Session token from Activate Agent. Must match agent_id.
string
required
Must be application/json

Path 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 1100. If omitted, the server default applies.
array
Optional list of memory type filters (e.g. ["fact", "decision"]).

Next Steps