---
title: "POST /v1/rerank"
method: POST
path: "/v1/rerank"
---

# POST /v1/rerank

`POST /v1/rerank`

Rerank search results by relevance

## Request body

- RerankRequest
  - `model` string, required — ID of the model to use for reranking
  - `query` string, required — The search query to compare documents against
  - `documents` string[], required — An array of document strings to be reranked. Alternatively, use embedding_ids instead.
  - `embedding_ids` string[] — An array of embedding IDs to rerank (alternative to documents). Remote content storage must be enabled.
  - `top_n` integer — Number of top results to return

## Response `200`

Reranking response

- RerankResponse
  - `id` string, required — Unique identifier for the rerank request
  - `model` string, required — ID of the model used
  - `usage` object, required — Usage statistics
    - `total_tokens` integer — Total number of tokens used
  - `results` object[], required — List of reranked results
    - `index` integer — Original index of the document in the input array
    - `document` object — The document object
      - `text` string — The document text
    - `relevance_score` number — Score indicating relevance to the query (higher is more relevant)

## Other responses

- `400` — Bad request error
- `401` — Authentication error

---

[API](https://skmtc.net/morphllm/apis/morph-api.md) · [All operations](https://skmtc.net/morphllm/apis/morph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/morphllm/morph-api/versions/9e3d888071b5/schema)