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.