Create version from draft
create_versionPublish one accepted draft checkpoint as a new immutable board version. Pass the exact current visibility; saving never changes audience, so a public board (every remix) changes publicly: confirm first. Reuse operationId to recover a lost response. The board may keep rendering after the version is saved.
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": {
"board": "<board>",
"operationId": "<operationId>",
"expectedCheckpointId": "<expectedCheckpointId>",
"expectedHeadVersionId": "<expectedHeadVersionId>",
"message": "<message>",
"visibility": "<visibility>"
},
"name": "create_version"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| board | Yes | Your board: handle/slug or a boardrepo.com URL. | |
| message | Yes | What this version changes, at most 500 characters. | |
| visibility | Yes | Exact current board visibility; saving never changes audience. | |
| operationId | Yes | Client-generated UUID. Reuse for retries of the same logical step; use a new one for a new edit or save. | |
| expectedCheckpointId | Yes | checkpoint.id from get_current_work. | |
| expectedHeadVersionId | Yes | savedHeadVersionId from get_current_work when stale is false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||