Add block to page
add_block_to_pageAdds a block to a page and generates its block ID automatically. Inserts content blocks at a set position in the page body or layout blocks into a named region.
Instructions
Add a block to a page (auto-generates the block id). Pass layoutRegion to add a layout block; omit it for a content block in the page body. 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 unless the page already stores that block - 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>",
"block": "<block>"
},
"name": "add_block_to_page"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block | Yes | ||
| pageId | Yes | Page id or slug | |
| position | No | 0-based insert position (content blocks only; default: end) | |
| layoutRegion | No | Layout region (e.g. 'header','footer') for a layout block; omit for a content block |