---
title: "Recall"
method: POST
path: "/v1/scopes/{scope_name}/recall"
tags: ["memory"]
---

# Recall

`POST /v1/scopes/{scope_name}/recall`

## Request

- Base URL: `https://api.tmcra.com`
- URL: `https://api.tmcra.com/v1/scopes/{scope_name}/recall`
- Auth: HTTP bearer

## Path parameters

- `scope_name` string, required

## Headers

- `X-TMCRA-On-Behalf-Of-Subject` string, nullable: Trusted subject attribution for server-side control-plane proxies. Requires a tokens:manage API key.

## Request body

- RecallRequest
  - `debug` boolean
  - `evidence_mode` 'raw' | 'auto' | 'compiled'
  - `max_windows` 8
  - `query` string, required
  - `query_time` string, date-time, nullable
  - `recall_profile` 'quality' | 'interactive'
  - `response_projection` 'full' | 'prompt_only'
  - `wait_for_job_id` string, nullable

## Response `200`

Successful Response

- RecallResponse
  - `debug` object, nullable
  - `evidence` object, required
  - `evidence_route` EvidenceRouteView, required
    - `reasons` string[], required
    - `requested` string, required
    - `selected` 'raw' | 'compiled', required
  - `index_job_id` string, required
  - `prompt_evidence` PromptEvidenceView, required
    - `content` string, required
    - `content_character_count` integer, required
    - `content_sha256` string, required
    - `format` 'text/plain' | 'application/json', required
    - `memory_context_block_count` integer, nullable
    - `mode` 'raw_hierarchical' | 'compiled_evidence_packet', required
    - `neighbor_block_count` integer, nullable
    - `schema_version` string, required
    - `source_block_count` integer, nullable
    - `source_text_verbatim` boolean, required
    - `trust_boundary` string, required
    - `window_count` integer, nullable
  - `query_id` string, required
  - `scope_name` string, required

## Other responses

- `422`: Validation Error
- `429`: Tenant quota, rate, or recall queue limit was reached.
- `503`: Recall capacity is temporarily unavailable.

---

[API](https://skmtc.dev/tmcra/apis/tmcra-memory-api.md) · [All operations](https://skmtc.dev/tmcra/apis/tmcra-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tmcra/apis/tmcra-memory-api/revisions/597be9dc7a3d?raw)