Update preferences for a listing.
PUT/preferences/:listing_id
Updates pricing preferences for a listing.
All fields are optional; only provided fields will be updated. This partial-update
behavior applies at the top level only — omitting a field (e.g. minimum_stay_rules_v3)
leaves it unchanged, but providing a field that holds an array of rules
(e.g. minimum_price_rules_v3) will completely replace the existing rule set
for that field; individual rules within an array cannot be merged or patched.
Always fetch the current preferences before writing and include every rule you
wish to retain — any rules omitted from an array will be permanently deleted.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 423
- 429
The updated listing preferences.
API key authorization failed.
Listing authorization failed, or the API key is read-only and may not be used with PUT.
Listing not found.
Another request is already in progress for this listing. Retry after the concurrent request completes.
Listing preferences not yet initialized. Retry after a brief delay.
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.