# Update a single pricing setting for a listing.

`PUT /preferences/{listing_id}/{setting}`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-put-preference-setting · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmPutPreferenceSetting` · Tag: Listing Preferences

Updates one of the following settings to a preset level (conservative/recommended/aggressive), or toggles automatic rate posting on/off.

| Setting | Accepted parameters |
|---|---|
| `base_price_adjustment` | `type`: `CON`, `REC`, or `AGG` |
| `day_of_week` | `type`: `CON`, `REC`, or `AGG` |
| `seasonality_adjustment` | `type`: `CON`, `REC`, or `AGG` |
| `last_minute_discount` | `type`: `CON`, `REC`, or `AGG` |
| `far_future_premium` | `type`: `CON`, `REC`, or `AGG` |
| `automatic_rate_posting` | `enabled`: `true` or `false` |

## Request

`PUT https://api.usewheelhouse.com/ss_api/v1/preferences/{listing_id}/{setting}`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Modifies data; read-only keys get `403 Forbidden`.

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `listing_id` | string | yes | The channel's unique listing identifier, or the Wheelhouse listing ID when `channel` is `wheelhouse`. |
| `setting` | string | yes | The setting to update. (one of: `base_price_adjustment`, `day_of_week`, `seasonality_adjustment`, `last_minute_discount`, `far_future_premium`, `automatic_rate_posting`) |

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `channel` | string | yes | Channel name the listing is on (the `channel` field of the [/listings](https://docs.usewheelhouse.com/rm/reference/rm-get-listings.md) response), or the literal `wheelhouse` to read `listing_id` as a Wheelhouse listing ID instead. See [Identifying Listings](https://docs.usewheelhouse.com/rm/concepts/listings.md). |

### Request body (`application/json`, required)

- `type` (string, one of: `CON`, `REC`, `AGG`): The preset level to apply. Required for all settings except `automatic_rate_posting`.
- `enabled` (boolean): The enabled state. Required for `automatic_rate_posting` only.

### Example request

```bash
curl -X PUT 'https://api.usewheelhouse.com/ss_api/v1/preferences/{listing_id}/{setting}?channel=<channel>' \
  -H 'X-Integration-Api-Key: <your RM API key>' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 204

The setting was updated successfully. No content is returned.

### 400

Invalid or missing parameter.

### 401

API key authorization failed.

### 403

Listing authorization failed, or the API key is read-only and may not be used with PUT.

### 404

Listing not found.

### 406

The listing is inactive. See the **Inactive Listings** section in the overview.

Body (`application/json`): object

- `error` (string, example: `Listing '12345' is inactive`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "Listing '12345' is inactive"
}
```

### 409

Another request is already in progress for this listing. Retry after the concurrent request completes.

### 423

Listing preferences not yet initialized.

### 429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the **Rate Limits** section in the overview for the recommended exponential backoff strategy.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```

## Notes for AI agents

The Wheelhouse MCP server gives agents these instructions for this operation. They apply equally when calling the API directly.

⚠️ **Requires user confirmation before calling.** This changes a live pricing setting for the listing, which affects the rates Wheelhouse recommends and may post going forward. Before calling, state to the user: the listing, the setting being changed, the current value (fetch via `rmGetPreferences` first if unknown), and the new value. Do not call until the user has explicitly confirmed.
