---
title: "Create Rerank"
method: POST
path: "/v1/rerank"
tags: ["rerank"]
---

# Create Rerank

`POST /v1/rerank`

Rerank documents by relevance to a query.

Authentication modes:
- Master key + user field: Use specified user (must exist)
- API key + user field: Use specified user (must exist)
- API key without user field: Use the shared "default" user

## Request body

- RerankRequest — Rerank request.
  - `documents` string[], required — List of document strings to rerank
  - `max_tokens_per_doc` integer, nullable — Per-document truncation limit
  - `model` string, required — Provider-prefixed model ID, e.g. 'cohere:rerank-v3.5'
  - `query` string, required — The search query to rerank documents against
  - `top_n` integer, nullable — Maximum number of results to return
  - `user` string, nullable — User ID for usage attribution

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.net/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/c05befed4db4/schema)