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

Evaluate recall.

Request

Base URL
https://{region}.turbopuffer.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/turbopuffer/apis/turbopuffer-api/docs/v1/namespaces/:namespace/_debug/recall/post.ts
A function with typed inputs. Its response is checked against the schema.

namespacestring required

The name of the namespace.

numinteger

The number of searches to run.

top_kinteger

Search for top_k nearest neighbors.

filtersunknown

include_ground_truthboolean

Include ground truth data (query vectors and true nearest neighbors) in the response.

rank_byunknown

The status of the cache warm request.

avg_recallnumber required

The average recall of the queries.

avg_exhaustive_countnumber required

The average number of documents retrieved by the exhaustive searches.

avg_ann_countnumber required

The average number of documents retrieved by the approximate nearest neighbor searches.

Oct 16, 2026c99c9da22ed1 Revision changes
- warning
  the request property's min was set to 0.00
- warning
  the request property's min was set to 0.00
Apr 1, 202669c1d82584de Revision changes
- info
  added the new optional request property