manage_flows
List, add, rename, or delete flows in an open Dorico project by ID—including removing extra flows added by MusicXML import—and return the updated flow list.
Instructions
List, add, rename or delete flows of the open project by id.
Returns:
Result dictionary with ``flows`` (flowID and flowName) read back after the
change.
Note:
Measured in Dorico Elements 6.2.40: renaming and deleting are refused in
Write mode (``kCommandNotAllowed``), so this switches to Setup mode and back.
Deleting opens a confirmation dialog that a person must answer in Dorico;
this waits up to ``wait_seconds`` for the flow to disappear and says so when
it has not. Deleting needs ``confirm=True``. Use it to remove the extra flow
a MusicXML import adds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "manage_flows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | rename and delete: flow id from action='list'. | |
| name | No | rename: the new name. | |
| action | No | List the flows, add one, rename one or delete one. | list |
| confirm | No | True authorises a change that discards work or cannot be undone. | |
| wait_seconds | No | delete: how long to wait for the person to confirm. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||