Promote dev draft
promote_dev_draftPromotes your per-user dev draft overlay onto a page's shared draft, replacing its blocks after composed block code is deployed. It refuses unsafe promotions that add warnings or empty content.
Instructions
Promote YOUR per-user dev draft overlay onto the page's shared draft (replaces the shared draft blocks; the overlay belongs to the token's user). Do this after the block code for the composed types is deployed to the site. Fails when you have no dev draft for the page. The promote is refused with DEV_DRAFT_PROMOTE_REFUSED when the dev draft introduces block warnings the shared draft does not already carry, or empties a language, the shared values or the flat content a shared-draft block holds, or leaves out a shared-draft block that holds content (it would be removed from the page); the error lists the blockWarnings and emptiedBlocks, where removed: true marks a left-out block. Fix the dev draft (update_page_blocks with target: 'devDraft') and promote again; pass force: true only after fixing is ruled out. Promoting a block whose type the workspace block manifest does not register is refused - run cmssy sync-manifest from the deployed code first.
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>"
},
"name": "promote_dev_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Promote even though the server refused it with DEV_DRAFT_PROMOTE_REFUSED. Use only after fixing the dev draft is ruled out - it overwrites the shared draft with the warnings and emptied blocks the refusal listed. | |
| pageId | Yes | Page id or slug |