---
title: "Changes to Create rerank"
method: POST
path: "/v2/router/rerank"
---

# Changes to Create rerank

`POST /v2/router/rerank`

> Every recorded change to this endpoint, newest first.
> 271 revisions in range; 82 not diffed.

## Timeline

Changed in 12 of 271 revisions.

- **2026-08-24** `addad33219df` — 1 breaking, 1 warning, 1 info
- **2026-08-21** `1586760a252f` — 1 warning, 1 info
- **2026-08-21** `4fdc24e562eb` — 1 breaking, 1 warning, 1 info
- **2026-08-20** `be3fe58ce389` — 1 warning, 1 info
- **2026-08-17** `f54fa34db0f4` — 1 breaking, 1 warning, 1 info
- **2026-08-17** `ed68e8b009d7` — 1 warning, 1 info
- **2026-08-17** `d46bd23ae34c` — 1 breaking, 1 warning, 1 info
- **2026-08-17** `f459ad9381eb` — 1 warning, 1 info
- **2026-08-14** `deb8d376faee` — 1 breaking, 1 warning, 1 info
- **2026-07-01** `f54a057bf682` — 3 breaking
- **2026-06-29** `cf2ebe8218c7` — 1 breaking, 2 info
- **2026-06-29** `bc4a415db9cb` — 1 info

## Changes

- **2026-08-24** `addad33219df` — 1 breaking, 1 warning, 1 info
  - the `top_n` request property type changed from `number` to `integer`
  - the `top_n` request property's min was set to `1.00`
  - added the new optional request property `return_documents`
- **2026-08-21** `1586760a252f` — 1 warning, 1 info
  - removed the request property `return_documents`
  - the `top_n` request property type was generalized from `integer` to `number`
- **2026-08-21** `4fdc24e562eb` — 1 breaking, 1 warning, 1 info
  - the `top_n` request property type changed from `number` to `integer`
  - the `top_n` request property's min was set to `1.00`
  - added the new optional request property `return_documents`
- **2026-08-20** `be3fe58ce389` — 1 warning, 1 info
  - removed the request property `return_documents`
  - the `top_n` request property type was generalized from `integer` to `number`
- **2026-08-17** `f54fa34db0f4` — 1 breaking, 1 warning, 1 info
  - the `top_n` request property type changed from `number` to `integer`
  - the `top_n` request property's min was set to `1.00`
  - added the new optional request property `return_documents`
- **2026-08-17** `ed68e8b009d7` — 1 warning, 1 info
  - removed the request property `return_documents`
  - the `top_n` request property type was generalized from `integer` to `number`
- **2026-08-17** `d46bd23ae34c` — 1 breaking, 1 warning, 1 info
  - the `top_n` request property type changed from `number` to `integer`
  - the `top_n` request property's min was set to `1.00`
  - added the new optional request property `return_documents`
- **2026-08-17** `f459ad9381eb` — 1 warning, 1 info
  - removed the request property `return_documents`
  - the `top_n` request property type was generalized from `integer` to `number`
- **2026-08-14** `deb8d376faee` — 1 breaking, 1 warning, 1 info
  - the `top_n` request property type changed from `number` to `integer`
  - the `top_n` request property's min was set to `1.00`
  - added the new optional request property `return_documents`
- **2026-07-01** `f54a057bf682` — 3 breaking
  - removed the enum value `EMAIL` of the request property `plugins/items/anyOf[subschema #1: PII redaction plugin (automatic language)]/entities/items/`
  - removed the enum value `EMAIL` of the request property `plugins/items/anyOf[subschema #2: PII redaction plugin (English)]/entities/items/`
  - removed the enum value `EMAIL` of the request property `plugins/items/anyOf[subschema #3: PII redaction plugin (Dutch)]/entities/items/`
- **2026-06-29** `cf2ebe8218c7` — 1 breaking, 2 info
  - removed `#/components/schemas/PIIRedactionPluginEn, #/components/schemas/PIIRedactionPluginNl` from the `plugins/items/` request property `oneOf` list
  - added `#/components/schemas/PIIRedactionPluginAuto, #/components/schemas/PIIRedactionPluginEn, #/components/schemas/PIIRedactionPluginNl` to the `plugins/items/` request property `anyOf` list
  - removed discriminator from `plugins/items/` request property
- **2026-06-29** `bc4a415db9cb` — 1 info
  - added the new optional request property `plugins`

---

[Operation](https://skmtc.dev/orq-ai/apis/orq-ai-api/docs/v2/router/rerank/post.md) · [API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [Page](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/router/rerank/post)