update_node
Update a mindmap node by providing a JSON object with only the fields to change—title, description, parent, position, styles—leaving other nodes untouched.
Instructions
Update a single node in a mindmap — all fields supported, no data loss.
This is the SAFE way to modify any field of a single node. It reads the full mindmap, applies targeted changes to one node, and syncs everything back. Other nodes (including their descriptions) are preserved untouched.
Unlike sync_nodes (which replaces ALL nodes and can destroy data), this tool only touches the specified node. Use it for:
Renaming a node (title)
Updating a node's description (markdown → Quill Delta conversion)
Changing the parent (re-parenting, with cycle detection)
Moving a node (pos_x, pos_y)
Changing any style field (color, bold, size_box, etc.)
Updating free_links
node_updates is a JSON string with any combination of fields: { "title": "New title", // string — new node title "descriptions": "markdown text", // string — markdown converted to Quill Delta "parent": 2, // int — new parent order_index (0 = root) "color": "0xFFFF6F91", // hex color string "pos_x": 240, // canvas X position "pos_y": 480, // canvas Y position "is_manual_position": true, // bool — preserve position "size_box": 1, // 0=normal, 1=category, 2=root, 3-11=larger "bold": true, // bool "italic": false, // bool "underline": false, // bool "line_type": 1, // 0=curve, 1=rounded, 2=square "line_style": 0, // 0=solid, 1=dashed "stroke_width": 2.5, // float "dot_radius": 6, // float "radius": 5, // int "border_size": 2, // int "label_size": 12, // float "icon_id": 0, // int "active_bg_colors": false, // bool "spacing_h": 2, // 0-10 "spacing_v": 0, // 0-10 "is_write_children": true, // propagate style to children (one-shot) "free_links": [3, 5] // list of order_indexes }
Only provided fields are updated — others remain untouched. Setting pos_x or pos_y automatically sets is_manual_position=true. Descriptions are converted from markdown to Quill Delta by the algorithm.
Args: id_mindmap: Mindmap ID order_index: Order index of the node to update (1-based) node_updates: JSON string with fields to update
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id_mindmap | Yes | ||
| order_index | Yes | ||
| node_updates | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |