---
title: "Recall As Of"
method: POST
path: "/api/v2/agents/{agent_id}/recall/as-of"
tags: ["Sessions & Agents", "Memory Operations"]
---

# Recall As Of

`POST /api/v2/agents/{agent_id}/recall/as-of`

Point-in-time recall: "What was true at this point in time?"

Returns memories stored before the specified datetime, excluding memories
created after or expired before as_of.

Example: "What memories did we have on 2025-11-01?"

Requires:
- X-Session-Token: {session_token}

## Path parameters

- `agent_id` string, required

## Headers

- `x-session-token` string, nullable
- `X-Api-Key` string, nullable

## Cookies

- `memanto_session_token` string, nullable

## Request body

- RecallAsOfRequest — Request body for point-in-time memory recall.
  - `as_of` string, date-time, required — Point-in-time — YYYY-MM-DD (defaults to end of day) or full ISO datetime e.g. 2025-11-01T14:30:00Z
  - `limit` integer, nullable — Max results
  - `type` string[], nullable — Memory type filters
  - `tags` string[], nullable — Tag filters

## Response `200`

Successful Response

- TemporalRecallResponse
  - `agent_id` string, required
  - `session_id` string, required
  - `memories` MemoryItem[], required
    - `id` string, nullable
    - `title` string
    - `content` string
    - `text` string
    - `type` string, nullable
    - `confidence` number, nullable
    - `status` string, nullable
    - `tags` string[]
    - `created_at` string, nullable
    - `updated_at` string, nullable
    - `expired_at` string, nullable
    - `expired_by` string, nullable
    - `actor_id` string, nullable
    - `source` string, nullable
    - `source_ref` string, nullable
    - `agent_id` string, nullable
    - `score` number, nullable
    - `provenance` string
    - `change_type` string, nullable
  - `count` integer, required
  - `temporal_mode` string, required
  - `as_of_date` string, nullable
  - `since_date` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/moorcheh-ai/apis/memanto-memory-that-ai-agents-love.md) · [All operations](https://skmtc.net/moorcheh-ai/apis/memanto-memory-that-ai-agents-love/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moorcheh-ai/memanto-memory-that-ai-agents-love/revisions/f8fc41287ced/schema)