update_graph_nodes
Edit a graph's topology — add/remove/rename nodes and rewire edges in one call. Applies ops in order (remove edges → remove nodes → update nodes → add nodes → add edges) and reports per-op results. Refuses on the workspace's assistant graph unless force is set. Editor role required (the canvas's own bar); scoped API keys cannot call it (their graphIds can't cover topology writes).
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": {
"graphId": "<graphId>"
},
"name": "update_graph_nodes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Required true to edit the workspace's assistant graph | |
| graphId | Yes | ||
| addEdges | No | {sourceNodeId, targetNodeId, kind?, condition?, label?, priority?} | |
| addNodes | No | Node specs (same fields as create_graph nodes, minus ref) | |
| updateNodes | No | {nodeId, …fields to patch} | |
| removeEdgeIds | No | ||
| removeNodeIds | No |