---
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`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/memory/namespaces/{namespace}/profiles/{profile_id}/recall`
- Auth: HTTP bearer

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

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

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

---

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