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

{
  "agent_id": "my-agent",
  "session_id": "sess_123abc",
  "memories": [
    {
      "id": "3e681f12-a28c-4d1d-9632-b8dadf1f9d0c",
      "title": "Latest Customer Feedback",
      "content": "Customer prefers async communication on Slack.",
      "text": "[PREFERENCE] Latest Customer Feedback\n\nCustomer prefers async communication on Slack.",
      "type": "preference",
      "confidence": 0.9,
      "status": "active",
      "tags": [],
      "created_at": "2026-05-08T18:47:46Z",
      "updated_at": "2026-05-08T18:47:46Z",
      "actor_id": "my-agent",
      "source": "agent",
      "source_ref": null,
      "scope_type": "agent",
      "scope_id": "my-agent",
      "score": null,
      "provenance": "explicit_statement",
      "validation_count": 0,
      "contradiction_detected": false
    }
  ],
  "count": 1,
  "temporal_mode": "recent"
}

​
Overview

Returns memories sorted by created_at descending (newest first). Useful when you want the latest context without running a semantic query — for example, summarizing the most recent activity for an agent. There is no query parameter for this endpoint; results are purely chronological.

​
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

​
limit
integer
Maximum number of results to return. Range 1–100. If omitted, the server default applies (RECALL_LIMIT).
​
type
array
Optional list of memory type filters (e.g. ["fact", "preference"]).
curl -X POST "http://localhost:8000/api/v2/agents/my-agent/recall/recent" \
  -H "X-Session-Token: your_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 10,
    "type": ["fact", "decision"]
  }'

{
  "agent_id": "my-agent",
  "session_id": "sess_123abc",
  "memories": [
    {
      "id": "3e681f12-a28c-4d1d-9632-b8dadf1f9d0c",
      "title": "Latest Customer Feedback",
      "content": "Customer prefers async communication on Slack.",
      "text": "[PREFERENCE] Latest Customer Feedback\n\nCustomer prefers async communication on Slack.",
      "type": "preference",
      "confidence": 0.9,
      "status": "active",
      "tags": [],
      "created_at": "2026-05-08T18:47:46Z",
      "updated_at": "2026-05-08T18:47:46Z",
      "actor_id": "my-agent",
      "source": "agent",
      "source_ref": null,
      "scope_type": "agent",
      "scope_id": "my-agent",
      "score": null,
      "provenance": "explicit_statement",
      "validation_count": 0,
      "contradiction_detected": false
    }
  ],
  "count": 1,
  "temporal_mode": "recent"
}

​
Next Steps