---
title: "Recall a profile's memories, ranked"
method: POST
path: "/ai/memory/namespaces/{namespace}/profiles/{profile_id}/recall"
tags: ["Memory"]
---

# Recall a profile's memories, ranked

`POST /ai/memory/namespaces/{namespace}/profiles/{profile_id}/recall`

Ranked memories for a question. Matching runs over the profile's memories and returns them in rank order with a relevance `score`; the score is null where the deployment's reranker is a passthrough, in which case order is the only signal. No model runs in this path — recall returns facts, it does not compose an answer.

## Path parameters

- `profile_id` string, required
- `namespace` string, required

## Request body

- RecallRequest
  - `query` string, required
  - `top_k` integer, nullable

## Response `200`

Successful Response

- RecallResponse
  - `data` RecalledMemory[], required
    - `id` string, required
    - `text` string, required
    - `recorded_at` string, nullable
    - `score` number, nullable — Relevance, 0-1. Null where the deployment's reranker is a passthrough; results are in rank order either way.

## Other responses

- `401` — Unauthorized
- `404` — The namespace does not exist
- `422` — Invalid request
- `502` — Upstream error

## Changes

> 99 revisions in range; 1 not diffed.

- **2026-09-25** `88481995b4ca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/ai/memory/namespaces/:namespace/profiles/:profile_id/recall/post.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/227c33b1ac9c?raw)