---
title: "Recall own-source and pass-governed memory"
method: POST
path: "/partner/v1/recall"
---

# Recall own-source and pass-governed memory

`POST /partner/v1/recall`

## Request

- Base URL: `https://passport.ego.ist`
- URL: `https://passport.ego.ist/partner/v1/recall`
- Auth: HTTP bearer

## Request body

- RecallRequest
  - `categories` string[], required
  - `query` string, nullable
  - `limit` integer

## Response `200`

Available rows and skipped categories

- RecallResponse
  - `rows` MemoryRow[], required
    - `memory_id` string, required
    - `content` string, required
    - `source` string, nullable, required
    - `category` string, required
    - `created_at` string, date-time, required
    - `occurred_at` string, date-time, nullable
    - `entities` object[]: Optional knowledge-graph entities directly evidenced by this memory's eligible facts. May be absent while extraction or graph annotation is unavailable.
      - `id` string, required
      - `type` 'person' | 'org' | 'place' | 'product' | 'project' | 'topic' | 'event' | 'activity' | 'other', required
      - `label` string, required
    - `client_id` string, nullable
    - `evidence_basis` string, nullable
    - `record_kind` string, nullable
    - `verified_issuer` string, nullable
    - `verified_at` string, date-time, nullable
  - `skipped_categories` object[], required
    - `category` string, required
    - `reason` 'no_pass' | 'once_only' | 'locked', required
  - `approval_url` string, uri, required

## Other responses

- `400`: Partner API error. Retry behavior depends on the status and error code.
- `401`: Bearer-token error
- `403`: Partner API error. Retry behavior depends on the status and error code.
- `429`: Partner API error. Retry behavior depends on the status and error code.
- `503`: Partner API error. Retry behavior depends on the status and error code.

---

[API](https://skmtc.dev/ego/apis/ai-passport-partner-api.md) - [All operations](https://skmtc.dev/ego/apis/ai-passport-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ego/apis/ai-passport-partner-api/revisions/d4e46c2809bf?raw)