> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memanto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Recall Recent

> Return the most recently stored memories, sorted newest-first.

## 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.

<ParamField header="X-Session-Token" type="string" required>
  Session token from [Activate Agent](/api-reference/sessions/activate-agent). Must match `agent_id`.
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Must be `application/json`
</ParamField>

## Path Parameters

<ParamField path="agent_id" type="string" required>
  The unique identifier of the agent.
</ParamField>

## Body

<ParamField body="limit" type="integer">
  Maximum number of results to return. Range `1`–`100`. If omitted, the server default applies (`RECALL_LIMIT`).
</ParamField>

<ParamField body="type" type="array">
  Optional list of memory type filters (e.g. `["fact", "preference"]`).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  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"]
    }'
  ```

  ```bash cURL (defaults) theme={null}
  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 '{}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - OK theme={null}
  {
    "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,
        "agent_id": "my-agent",
        "score": null,
        "provenance": "explicit_statement"
      }
    ],
    "count": 1,
    "temporal_mode": "recent"
  }
  ```

  ```json 401 - Unauthorized (Expired Token) theme={null}
  {
    "detail": {
      "error": "SessionExpired",
      "message": "Session has expired",
      "details": {}
    }
  }
  ```

  ```json 400 - Bad Request (Limit Too Large) theme={null}
  {
    "detail": {
      "error": "k_too_large",
      "message": "k exceeds maximum of 100",
      "actual_k": 200,
      "max_k": 100
    }
  }
  ```

  ```json 500 - Server Error theme={null}
  {
    "detail": {
      "error": "InternalServerError",
      "message": "An unexpected error occurred",
      "details": {
        "original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
      }
    }
  }
  ```
</ResponseExample>

## Next Steps

* [Recall](/api-reference/search/recall) for semantic search by query
* [Recall As Of](/api-reference/search/recall-as-of) for point-in-time queries
* [Recall Changed Since](/api-reference/search/recall-changed-since) for differential retrieval