Rerank Documents
POST/v1/reranking
Authorization
Authorizationstringrequired
Bearer token for API authentication. Format: `Bearer YOUR_API_KEY`
Request Body
modelstringdefault:
mixedbread-ai/mxbai-rerank-large-v2The model to use for reranking documents.
Constraints
•Minimum length: 1•Maximum length: 500
querystringrequired
The query to rerank the documents.
Constraints
•Minimum length: 1•Maximum length: 32000
inputany[]required
The input documents to rerank.
Constraints
•Minimum items: 1•Maximum items: 1000
rank_fieldsarray
The fields of the documents to rank.
Constraints
•Minimum items: 1
top_kintegerdefault:
-1The number of documents to return.
Constraints
•Minimum: 1
return_inputbooleandefault:
falseWhether to return the documents.
rewrite_querybooleandefault:
falseWether or not to rewrite the query before passing it to the reranking model
Response Body
modelstringrequired
The model used
objectstringdefault:
listThe object type of the response
top_kintegerrequired
The number of documents to return.
return_inputbooleanrequired
Whether to return the documents.
Last updated: October 6, 2025