---
title: "CreateRerankRequest"
---

## Fields

| Field                                                                                                                                                                             | Type                                                                                                                                                                              | Required                                                                                                                                                                          | Description                                                                                                                                                                       | Example                                                                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `http_referer`                                                                                                                                                                    | *Optional[str]*                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                | The app identifier should be your app's URL and is used as the primary identifier for rankings.<br/>This is used to track API usage per application.<br/>                         |                                                                                                                                                                                   |
| `x_open_router_title`                                                                                                                                                             | *Optional[str]*                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                | The app display name allows you to customize how your app appears in OpenRouter's dashboard.<br/>                                                                                 |                                                                                                                                                                                   |
| `x_open_router_categories`                                                                                                                                                        | *Optional[str]*                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                | Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.<br/>                                                                        |                                                                                                                                                                                   |
| `request_body`                                                                                                                                                                    | [operations.CreateRerankRequestBody](../operations/creatererankrequestbody.mdx)                                                                                                    | :heavy_check_mark:                                                                                                                                                                | N/A                                                                                                                                                                               | \{<br/>"documents": [<br/>"Paris is the capital of France.",<br/>"Berlin is the capital of Germany."<br/>],<br/>"model": "cohere/rerank-v3.5",<br/>"query": "What is the capital of France?",<br/>"top_n": 3<br/>} |