v38

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-31148285.5 KB

Evaluate recall.

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

Path parameters

namespacestring required

The name of the namespace.

Request body

numinteger

The number of searches to run.

top_kinteger

Search for top_k nearest neighbors.

{"stackTrail":"paths:/v1/namespaces/{namespace}/_debug/recall:post:requestBody:content:application/json:schema:properties:filters","oasType":"schema","type":"unknown","description":"Filter by attributes. Same syntax as the query endpoint.","extensionFields":{"x-stainless-any":true}}
include_ground_truthboolean

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

{"stackTrail":"paths:/v1/namespaces/{namespace}/_debug/recall:post:requestBody:content:application/json:schema:properties:rank_by","oasType":"schema","type":"unknown","description":"The ranking function to evaluate recall for. If provided, `num` must be either null or 1.\n","extensionFields":{"x-stainless-any":true}}

Response

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.