Change a tool document
tools_apply_commandsChange one document in any builder: roadmap (Outcome-Based Roadmap), roi (ROI Calculator), noice (NOICE Prioritization), ost (Opportunity Solution Tree), usm (User Story Map), vsm (Value Stream Map), cfd (Cumulative Flow Diagram), wardley (Wardley Map). Apply up to 25 commands as one atomic batch: all apply or none do. Read the document with tools_get_document first. It returns the toolKey to pass here, the version to pass as expectedVersion, and the commands that builder takes, each with its fields. A later command may name an entity an earlier one created only if you supplied no ids; read the result for the ids it assigned. StartOver clears a document, and RestoreTo with an event id from tools_get_history puts it back to that point. Send the same batchId again to retry safely after a timeout.
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": {
"toolKey": "<toolKey>",
"documentId": "<documentId>",
"expectedVersion": "<expectedVersion>",
"commands": "<commands>"
},
"name": "tools_apply_commands"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| batchId | No | Your id for this batch. Repeating it returns the stored result instead of writing twice. | |
| toolKey | Yes | The document's toolKey, from tools_get_document. | |
| commands | Yes | Commands from the document's catalog in tools_get_document: each one is its type plus that command's fields. | |
| documentId | Yes | The document id, from tools_list_documents. | |
| expectedVersion | Yes | The version you last read from tools_get_document. A stale version returns a conflict with what changed. |