---
title: "Changes to Create Rerank"
method: POST
path: "/v1/rerank"
---

# Changes to Create Rerank

`POST /v1/rerank`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 21 revisions.

- **2026-09-29** `2f7a4a0aac8f`: 1 info
- **2026-09-29** `da70d9cd1957`: 1 breaking
- **2026-09-21** `5fdbd3614b8c`: 1 info
- **2026-07-11** `0fd1d281f985`: 1 info
- **2026-06-12** `0c595f53fc63`: 1 breaking, 2 warning, 10 info
- **2026-03-24** `50ec08f1fdf6`: 2 breaking, 10 info
- **2026-03-10** `ef3add9564c0`: 2 breaking, 4 warning, 2 info
- **2026-03-04** `618db9823ac3`: 2 breaking, 6 info
- **2026-03-04** `46bc88767a37`: 3 breaking, 2 warning, 9 info

## Changes

- **2026-09-29** `2f7a4a0aac8f`: 1 info
  - endpoint added
- **2026-09-29** `da70d9cd1957`: 1 breaking
  - api path removed without deprecation
- **2026-09-21** `5fdbd3614b8c`: 1 info
  - added the optional property `usage/prompt_tokens_details` to the response with the `200` status
- **2026-07-11** `0fd1d281f985`: 1 info
  - added the non-success response with the status `400`
- **2026-06-12** `0c595f53fc63`: 1 breaking, 2 warning, 10 info
  - the `detail` response's property type changed from `array` to `string` for status `422`
  - removed the optional property `usage/carbon` from the response with the `200` status
  - removed the optional property `usage/requests` from the response with the `200` status
  - api operation id `rerank_v1_rerank_post` removed and replaced with `create_rerank_v1_rerank_post`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the optional property `headers` to the response with the `422` status
  - the response property `detail` became required for the status `422`
  - the `impacts` response's property default value `{"kWh":0,"kgCO2eq":0}` was added for the status `200`
  - added the required property `status_code` to the response with the `422` status
- **2026-03-24** `50ec08f1fdf6`: 2 breaking, 10 info
  - the `usage/carbon/kWh` response's property type changed from `number` to `object` for status `200`
  - the `usage/carbon/kgCO2eq` response's property type changed from `number` to `object` for status `200`
  - added the optional property `usage/carbon/kWh/max` to the response with the `200` status
  - added the optional property `usage/carbon/kWh/min` to the response with the `200` status
  - added the optional property `usage/carbon/kgCO2eq/max` to the response with the `200` status
  - added the optional property `usage/carbon/kgCO2eq/min` to the response with the `200` status
  - added the optional property `usage/impacts` to the response with the `200` status
  - the `kWh` response's property default value `0` was removed for the status `200`
  - the `kgCO2eq` response's property default value `0` was removed for the status `200`
  - response property `usage/carbon` deprecated
  - response property `usage/carbon/kWh` deprecated
  - response property `usage/carbon/kgCO2eq` deprecated
- **2026-03-10** `ef3add9564c0`: 2 breaking, 4 warning, 2 info
  - the `usage/carbon/kWh` response's property type changed from `object` to `number` for status `200`
  - the `usage/carbon/kgCO2eq` response's property type changed from `object` to `number` for status `200`
  - removed the optional property `usage/carbon/kWh/max` from the response with the `200` status
  - removed the optional property `usage/carbon/kWh/min` from the response with the `200` status
  - removed the optional property `usage/carbon/kgCO2eq/max` from the response with the `200` status
  - removed the optional property `usage/carbon/kgCO2eq/min` from the response with the `200` status
  - the `kWh` response's property default value `0` was added for the status `200`
  - the `kgCO2eq` response's property default value `0` was added for the status `200`
- **2026-03-04** `618db9823ac3`: 2 breaking, 6 info
  - the `usage/carbon/kWh` response's property type changed from `number` to `object` for status `200`
  - the `usage/carbon/kgCO2eq` response's property type changed from `number` to `object` for status `200`
  - added the optional property `usage/carbon/kWh/max` to the response with the `200` status
  - added the optional property `usage/carbon/kWh/min` to the response with the `200` status
  - added the optional property `usage/carbon/kgCO2eq/max` to the response with the `200` status
  - added the optional property `usage/carbon/kgCO2eq/min` to the response with the `200` status
  - the `kWh` response's property default value `0` was removed for the status `200`
  - the `kgCO2eq` response's property default value `0` was removed for the status `200`
- **2026-03-04** `46bc88767a37`: 3 breaking, 2 warning, 9 info
  - the response property `detail` became optional for the status `422`
  - the `detail` response's property type changed from `string` to `array` for status `422`
  - removed the required property `status_code` from the response with the `422` status
  - removed the optional property `headers` from the response with the `422` status
  - removed the optional property `usage/impacts` from the response with the `200` status
  - api operation id `create_rerank_v1_rerank_post` removed and replaced with `rerank_v1_rerank_post`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `503`
  - added the optional property `usage/carbon` to the response with the `200` status
  - added the optional property `usage/requests` to the response with the `200` status

---

[Operation](https://skmtc.dev/betagouv/apis/opengatellm/docs/v1/rerank/post.md) - [API](https://skmtc.dev/betagouv/apis/opengatellm.md) - [Page](https://skmtc.dev/betagouv/apis/opengatellm/changes/v1/rerank/post)
