> ## 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 As Of

> Point-in-time recall — return memories as they existed at a specified historical timestamp.

## 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](/api-reference/search/recall) instead.

## 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="as_of" type="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`.
</ParamField>

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

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

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

  ```bash cURL (date-only — interpreted as end of day UTC) theme={null}
  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-01",
      "type": ["fact", "decision"]
    }'
  ```
</RequestExample>

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

  ```json 401 - Unauthorized (Missing Token) theme={null}
  {
    "detail": "Missing session token. Use X-Session-Token header."
  }
  ```

  ```json 422 - Validation Error (Missing as_of) theme={null}
  {
    "detail": [
      {
        "type": "missing",
        "loc": ["body", "as_of"],
        "msg": "Field required",
        "input": {}
      }
    ]
  }
  ```

  ```json 422 - Validation Error (Bad Date) theme={null}
  {
    "detail": [
      {
        "type": "value_error",
        "loc": ["body", "as_of"],
        "msg": "Value error, Invalid value '2026-13-40'. Use YYYY-MM-DD or ISO 8601 datetime.",
        "input": "2026-13-40"
      }
    ]
  }
  ```

  ```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 Changed Since](/api-reference/search/recall-changed-since) to find modifications after a specific date
* [Recall](/api-reference/search/recall) for standard semantic search