Update page blocks
update_page_blocksReplace all content blocks on a page, keeping existing content for blocks with matching ids. Surfaces blockWarnings when saved content violates the workspace block manifest so you can fix and resave.
Instructions
Set the full content blocks array on a page (replaces all existing content blocks). Blocks with matching ids keep their existing content when not provided. If the result includes blockWarnings, the saved content violates the workspace block manifest (unknown field, wrong value shape, or a stored block whose type is no longer registered) - correct the content and save again, unless the warning is about a stored block whose type is no longer registered: that one is a manifest problem, so restore or sync the type, or find the block with list_block_usage and migrate or remove it. When the warnings also say when the workspace block manifest was last synced, the field or type may simply be newer than the manifest: if the site's code declares it, keep the content and sync the manifest (cmssy sync-manifest in the site's repo) instead. A block whose type the workspace block manifest does not register is refused on the shared draft unless the page already stores that block - compose types that are not deployed yet in target: 'devDraft' and promote once the code ships; pick registered types from list_block_types.
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>",
"blocks": "<blocks>"
},
"name": "update_page_blocks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blocks | Yes | Full array of content blocks to set on the page (replaces all) | |
| pageId | Yes | Page id or slug | |
| target | No | 'draft' (default) writes the shared page draft. 'devDraft' writes YOUR per-user dev draft overlay (owned by the token's user) - use it to compose with block types that are not deployed to the site yet; promote it with promote_dev_draft after the code ships. A dev-draft block sent with only id and type inherits every stored bucket it leaves out (content, settings, style, advanced, shared values, translations, metadata) from your dev draft, else from the shared draft; send an empty object ({}) to clear a bucket. |