---
title: "Create Reranks"
method: POST
path: "/v1/reranks"
---

# Create Reranks

`POST /v1/reranks`

## Request

- Base URL: `https://api.empiriolabs.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.empiriolabs.ai/v1/reranks`
- Auth: none declared
- TypeScript: <https://skmtc.dev/empiriolabs/apis/empiriolabs-gateway/docs/v1/reranks/post.ts> (a function with typed inputs; its response is checked against the schema)

Route rerank requests to a rerank worker (qwen3-rerank, etc.).

Body shape (flat, OpenAI-compat-ish):
  {model, query, documents, top_n?, instruct?, return_documents?}
Worker returns the upstream rerank response with `usage.cost_usd` attached.

## Response `200`

Successful Response

- unknown

---

[API](https://skmtc.dev/empiriolabs/apis/empiriolabs-gateway.md) - [All operations](https://skmtc.dev/empiriolabs/apis/empiriolabs-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/empiriolabs/apis/empiriolabs-gateway/revisions/94bb966b0560?raw)