Skip to main content

Rerank

POST https://gateway-api.mastra.ai/v1/rerank

Orders documents by relevance to a query. Use it after retrieval to pick the best context for a prompt.

curl https://gateway-api.mastra.ai/v1/rerank \
-H "Authorization: Bearer $MASTRA_GATEWAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "cohere/rerank-v5-fast",
"query": "capital of France",
"documents": ["Berlin is in Germany.", "Paris is the capital of France."],
"top_n": 1
}'

model:

string
A rerank model from `/v1/models`.

query:

string
The search query.

documents:

string[]
1 to 1,000 non-empty strings.

top_n?:

number
Number of results to return. Can't exceed the number of documents.

The response contains results, each with the index of a document in your request and its relevance_score, ordered from most to least relevant.