Propose a settings change
propose_store_settingsValidates a proposed change to one store's settings, live or not, with the dashboard's own checks, and returns each setting before and after with a change_token valid for 15 minutes. Saves nothing. Covered: header title, greeting and starter questions and the welcome and goodbye popups, in one language the chat already speaks per call; colours; handoff on or off, business hours, time zone and the away and in-hours messages (one text for every language); switches (add to cart, ratings, photos, suggested replies); promoted products; switching rules off. Changed only on the dashboard: voice, custom instructions and tone, the pages, the allowed websites, the country filter, the monthly cap, going live, sign-in methods, the team, and connecting channels or a mailbox. Needs the settings permission and works only for stores the person owns.
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": {
"store_id": "<store_id>",
"changes": "<changes>"
},
"name": "propose_store_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| changes | Yes | ||
| store_id | Yes | The store's store_id (not its name). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| saved | Yes | ||
| changes | Yes | ||
| store_id | Yes | ||
| change_token | Yes | ||
| expires_in_minutes | No |