# Perform reranking inference on the service

**POST /_inference/rerank/{inference_id}**



## Required authorization

* Cluster privileges: `monitor_inference`



## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth


## Parameters

### Path parameters
- **inference_id** (string)
  The unique identifier for the inference endpoint.

### Query parameters
- **timeout** (string)
  The amount of time to wait for the inference request to complete.

### Body: application/json (object)

- **query** (string)
  Query input.
- **input** (array[string])
  The documents to rank.
- **return_documents** (boolean)
  Include the document text in the response.
- **top_n** (number)
  Limit the response to the top N documents.
- **task_settings** (object)
  Task settings for the individual inference request.
  These settings are specific to the task type you specified and override the task settings specified when initializing the service.


## Responses
### 200


#### Body: application/json (object)
- **rerank** (array[object])



[Powered by Bump.sh](https://bump.sh)