Update preferences for a batch of listings.
PUT/preferences
Updates pricing preferences for multiple listings in one request.
Returns status 207 if some updates failed, 424 if all updates failed.
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
- 207
- 401
- 403
- 424
- 429
All updates succeeded.
Some updates succeeded and some failed.
API key authorization failed.
The API key is read-only and may not be used with PUT.
All updates failed.
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.