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

# POST /v1/rerank

`POST /v1/rerank`

Cohere v1-compatible text-only subset over SIE's native score primitive. Supported request fields are model, query, string documents, top_n, return_documents, and the documented SIE options extension. Unknown or unsupported fields reject with 400. The adapter rejects partial native results and forwards only authoritative worker-emitted usage.

## Headers

- `X-SIE-MACHINE-PROFILE` string, nullable
- `X-SIE-Pool` string, nullable
- `X-SIE-SDK-Version` string, nullable

## Request body

- RerankRequest
  - `documents` string[], required — One to 1,000 nonblank text candidates. Execution is internally batched within the selected model profile's max_batch_tokens limit.
  - `model` string, required — SIE model id. Blank or whitespace-only values are rejected.
  - `options` RerankOptions
    - `max_seq_length` integer, nullable — Positive request-time sequence-length cap, clamped to the model's configured ceiling. Reranker truncation preserves the instruction and query and truncates candidate document tokens first.
    - `profile` string, nullable — Named SIE model profile. Blank values are rejected.
  - `query` string, required — Text query. Blank or whitespace-only values are rejected.
  - `return_documents` boolean, nullable
  - `top_n` integer, nullable

## Response `200`

Cohere v1-compatible subset response

- RerankResponse
  - `model` string, required
  - `results` RerankResult[], required
    - `document` RerankDocument
      - `text` string, required
    - `index` integer, required
    - `relevance_score` number, double, required
  - `usage` ScoreUsage, required
    - `images` integer, nullable
    - `input_tokens` integer, required

## Other responses

- `400` — Invalid request
- `401` — Missing or invalid bearer token
- `404` — Model not found
- `409` — Bundle override conflicts with model routing
- `413` — Request body too large
- `500` — Malformed or partial native score result; gateway auth enabled but no tokens configured
- `502` — MODEL_LOAD_FAILED
- `503` — Provisioning, model loading, or capacity exhausted
- `504` — Result channel closed

---

[API](https://skmtc.net/superlinked/apis/sie-gateway.md) · [All operations](https://skmtc.net/superlinked/apis/sie-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/superlinked/sie-gateway/versions/06a326e2c3e9/schema)