Update price list
update_price_listChange a price list's name, percent discount or markup, active date window, and published sales channels. Adjust how catalogue prices apply to buyers; fixed prices are set separately.
Instructions
Rename a price list, change its percentOff (-1000 to 99.99, 2 decimals, negative = a markup; it prices every product the list holds no fixed price for) its startsAt / endsAt window (null clears a bound), or the sales channels it is published to (channels replaces the whole set, [] unpublishes it from every channel, leave it out to keep). Fixed prices are changed with set_price_list_entry / set_price_list_entries. Carts already priced from the list keep their prices until the buyer adds again; orders keep theirs.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "update_price_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The price list's id (from list_price_lists) | |
| name | No | New unique name | |
| endsAt | No | ISO date-time the list stops pricing buyers at, later than startsAt. null clears it (no end); leave it out to keep it. Outside its window a list prices nobody: its buyers pay catalogue prices. | |
| channels | No | Keys of the sales channels to publish the list to (from list_sales_channels), at most 20. A channel takes one undated base list plus dated lists whose windows do not overlap; a clash is refused (CHANNEL_BASE_TAKEN or CHANNEL_WINDOW_OVERLAP). Anyone can read the prices of a list published to a PUBLIC channel. | |
| startsAt | No | ISO date-time the list starts pricing buyers from. null clears it (priced from now on); leave it out to keep it. | |
| percentOff | No | Percent taken off the catalogue price (and every volume break) of each product the list holds no fixed price for: -1000 to 99.99, at most two decimals (12.5 = 12.5% off). A negative value is a markup above the catalogue (-10 = 10% more). 0 = the list prices only through its fixed prices. |