Update region settings
update_region_settingsSet one page layout region's settings, such as sidebar width or header variant, with manifest validation and a single version-guarded write that leaves other regions unchanged.
Instructions
Set the settings of one layout region on a page, e.g. a sidebar's width or a header's variant. Reads the page's current region settings, replaces only the named region and writes the whole list back (page.updateLayout with layoutRegionSettings, one version-guarded write); entries for regions or keys the manifest no longer declares are pruned on the way. Values are validated against the workspace layout manifest's region settings schema: an unknown region, an unknown key, or non-empty values on a region that declares no settings (such a region accepts {} only) is rejected with the backend's BAD_USER_INPUT message. Child pages inherit the region's settings unless they set their own (see get_page.resolvedRegions).
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": {
"pageId": "<pageId>",
"region": "<region>",
"values": "<values>"
},
"name": "update_region_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pageId | Yes | The page id (from list_pages/get_page) | |
| region | Yes | Layout region name declared by the workspace's layout manifest, e.g. 'sidebar' or 'header' | |
| values | Yes | Settings values for the region, keyed as the manifest's region settings schema declares. Replaces this region's values; other regions keep theirs. A region that declares no settings accepts {} only. | |
| expectedVersion | No | Optimistic-concurrency guard. Defaults to the version read before the write. |