> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.partnerpage.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.partnerpage.io/_mcp/server.

# Update the recommended order of a partner entry

POST https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/{directoryId}/entries/partners/{entryId}/update-recommended-order/

Move an entry to a row of the recommended sort list. `recommendedOrder` is the zero-based target row, counting from the top of the list (placed entries by position, then entries without one). The entry takes that row and the entries below it move down by one; an entry dropped below the placed entries also gives a position to the unplaced entries above it.

Reference: https://docs.partnerpage.io/api-reference/entry/partner-entry/update-the-recommended-order-of-a-partner-entry

## Authentication

- `Authorization` header (required) (prefixed with ` Token   `) — Your API key, sent as `Authorization: Token <your API key>`

## Request

### Path parameters

- `directoryId` (string, required) — id of the directory
- `entryId` (string, required) — id of the entry

## Response

### 200

Successful operation

- `href` (string, required)
- `id` (string, required)
- `created` (datetime, required)
- `modified` (datetime, required)
- `headline` (string, required, nullable)
- `title` (string, required)
- `type` (string, required)
- `slug` (string, required)
- `featured` (boolean, required)
- `status` (string, required)
- `tier` (string, required, nullable)
- `recommendedOrder` (integer, optional, nullable)
- `image` (string, optional, nullable)
- `pendingReview` (boolean, optional, nullable)

## Errors

### 400 Bad Request Error

Bad Request

- `any`

### 403 Forbidden Error

This feature is not enabled for this directory

- `any`

## Examples

**Response**

```json
{
  "href": "string",
  "id": "string",
  "created": "2024-01-15T09:30:00Z",
  "modified": "2024-01-15T09:30:00Z",
  "headline": "string",
  "title": "string",
  "type": "string",
  "slug": "string",
  "featured": true,
  "status": "string",
  "tier": "string",
  "recommendedOrder": 1,
  "image": "string",
  "pendingReview": true
}
```

**SDK Code**

```python
import requests

url = "https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/directoryId/entries/partners/entryId/update-recommended-order/"

headers = {"Authorization": "Token  <apiKey>"}

response = requests.post(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/directoryId/entries/partners/entryId/update-recommended-order/';
const options = {method: 'POST', headers: {Authorization: 'Token  <apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```