Update sales channel
update_sales_channelChange a sales channel's name, display mode, price access or currency without altering its key. Use it to rename a channel or restrict who sees prices and can check out.
Instructions
Rename a sales channel or change its displayMode, priceAccess or currency. The key cannot change. Changing the currency abandons the carts open on the channel - check activeCartCount first. Narrowing priceAccess refuses carts and checkout to buyers who no longer qualify; their carts are kept and come back if access returns. Which lists price the channel is changed on the price list (update_price_list channels).
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_sales_channel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The sales channel's id (from list_sales_channels) | |
| name | No | New display name | |
| currency | No | Omit to keep it; null or the default currency sells in the default currency, else one of the workspace's additional currencies. A change abandons the channel's open carts (activeCartCount) | |
| displayMode | No | How visitors and customers without a company read the channel's prices: net (VAT added on top) or gross (VAT inside). Default gross; a company buyer keeps their company's mode. | |
| priceAccess | No | Who sees the channel's prices and may buy through it: PUBLIC - anyone (default); MEMBERS - signed-in customers, and registration is open; COMPANY_MEMBERS - buyers of an approved company, the one to use for trade prices. Others get prices withheld and carts refused. |