---
title: "POST /v1/namespaces/{namespace}/_debug/recall"
method: POST
path: "/v1/namespaces/{namespace}/_debug/recall"
---

# POST /v1/namespaces/{namespace}/_debug/recall

`POST /v1/namespaces/{namespace}/_debug/recall`

Evaluate recall.

## Path parameters

- `namespace` string, required

## Request body

- object
  - `num` integer — The number of searches to run.
  - `top_k` integer — Search for `top_k` nearest neighbors.
  - `filters` unknown
  - `include_ground_truth` boolean — Include ground truth data (query vectors and true nearest neighbors) in the response.
  - `rank_by` unknown

## Response `200`

The status of the cache warm request.

- object — The response to a successful cache warm request.
  - `avg_recall` number, required — The average recall of the queries.
  - `avg_exhaustive_count` number, required — The average number of documents retrieved by the exhaustive searches.
  - `avg_ann_count` number, required — The average number of documents retrieved by the approximate nearest neighbor searches.
  - `ground_truth` object[] — Ground truth data including query vectors and true nearest neighbors. Only included when include_ground_truth is true.
    - `query_vector` number[], required — The query vector used for this search.
    - `nearest_neighbors` Row[], required — The true nearest neighbors with their distances and vectors.
      - `id` union, required — An identifier for a document.
        - string, uuid — A UUID.
        - string — A string ID.
        - integer — An integer ID.
      - `vector` union — A vector embedding associated with a document.
        - number[] — A dense vector encoded as an array of floats.
        - string — A dense vector encoded as a base64 string.

## Other responses

- `default` — An error response.

---

[API](https://skmtc.net/turbopuffer/apis/turbopuffer-api.md) · [All operations](https://skmtc.net/turbopuffer/apis/turbopuffer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/turbopuffer/turbopuffer-api/revisions/245e887f04ab/schema)