Update listing basic fees

Upsert replaces stored listing-default cleaningFee only when cleaningFee is sent; omitting it keeps the stored default. This PUT cannot clear only the listing default while keeping overrides — use DELETE on the listing to remove the whole document. channelConfigurations is required: send [] to store no overrides (clears existing). Omitting channelConfigurations is 400. An override entry may omit cleaningFee (channel only); GET by channel then falls back to the listing default. Do not send _id or lastUpdated on write; they are server-owned. When shouldUpdateSubUnits is true, child listings are overwritten with the same payload (not a merge of each child's previous settings).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Listing id (for example 5f8d0d55b54764421b7156c9).

Query Params
boolean

When true, overwrites child listings with the same payload as this request (not a merge of each child's previous settings). Example: false.

Body Params
cleaningFee
object

Listing-default cleaning fee (currently the only basic fee supported). Send to set or replace the default. Omit to leave the stored default unchanged. This PUT cannot clear only the listing default while keeping channel overrides — use DELETE listings/{listingId} to remove the whole basic-fees document (default and overrides).

channelConfigurations
array of objects
required

Per-channel cleaning fee overrides. Required on PUT. Send [] for no overrides — that replaces any stored overrides. Omitting the field is 400. An entry may omit cleaningFee (channel only); effective fee then falls back to the listing default.

channelConfigurations*
Responses

400

The input provided is invalid.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json