Skip to main content
POST
/
api
/
v2
/
agents
/
{agent_id}
/
recall
/
changed-since
curl -X POST "http://localhost:8000/api/v2/agents/my-agent/recall/changed-since" \
  -H "X-Session-Token: your_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "since": "2026-05-01",
    "limit": 20,
    "type": ["fact", "decision"]
  }'

{
  "agent_id": "my-agent",
  "session_id": "sess_123abc",
  "since_date": "2026-05-01T00:00:00+00:00",
  "memories": [
    {
      "id": "4f792e13-b39d-5e2e-a743-c9ebef2e0e1d",
      "title": "System Upgrade",
      "content": "System upgraded to v2.0",
      "text": "[FACT] System Upgrade\n\nSystem upgraded to v2.0",
      "type": "fact",
      "confidence": 0.9,
      "status": "active",
      "tags": [],
      "created_at": "2026-05-04T10:15:30Z",
      "updated_at": "2026-05-04T10:15:30Z",
      "actor_id": "my-agent",
      "source": "agent",
      "scope_type": "agent",
      "scope_id": "my-agent",
      "score": null,
      "provenance": "explicit_statement",
      "validation_count": 0,
      "contradiction_detected": false,
      "change_type": "created"
    }
  ],
  "count": 1,
  "temporal_mode": "changed_since"
}

​
Overview

Returns memories that were created or updated after the specified since timestamp — useful for “what changed since last week?” workflows. This endpoint lists memories chronologically (sorted by updated_at descending) — 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

​
since
string
required
Start of the change window. Accepts YYYY-MM-DD (interpreted as start of day UTC) or a full ISO 8601 datetime, e.g. 2026-05-01T00:00: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/changed-since" \
  -H "X-Session-Token: your_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "since": "2026-05-01",
    "limit": 20,
    "type": ["fact", "decision"]
  }'

{
  "agent_id": "my-agent",
  "session_id": "sess_123abc",
  "since_date": "2026-05-01T00:00:00+00:00",
  "memories": [
    {
      "id": "4f792e13-b39d-5e2e-a743-c9ebef2e0e1d",
      "title": "System Upgrade",
      "content": "System upgraded to v2.0",
      "text": "[FACT] System Upgrade\n\nSystem upgraded to v2.0",
      "type": "fact",
      "confidence": 0.9,
      "status": "active",
      "tags": [],
      "created_at": "2026-05-04T10:15:30Z",
      "updated_at": "2026-05-04T10:15:30Z",
      "actor_id": "my-agent",
      "source": "agent",
      "scope_type": "agent",
      "scope_id": "my-agent",
      "score": null,
      "provenance": "explicit_statement",
      "validation_count": 0,
      "contradiction_detected": false,
      "change_type": "created"
    }
  ],
  "count": 1,
  "temporal_mode": "changed_since"
}

​
Next Steps