create_nodes
mutationSince v1.0Create new node instances. Node type must already exist in the metamodel (use get_metamodel to check, or add_node_type to create). Changes are applied immediately and broadcast to all connected browser users in real-time.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
folder_id | String | — | [create_nodes] Optional UUID of a folder to place the new nodes in. | |
locale | String | — | [create_nodes] Optional locale code. Node type names are resolved from this locale to the model's default language. | |
nodes | Array<Object> | ✓ | [create_nodes] Array of node objects to create. Each must have node_type (required) and label (required). Optional: description, properties (key-value pairs). Required. |
Example Request
{"nodes": [{"node_type": "Feature", "label": "OAuth Integration", "description": "Add OAuth 2.0 support", "properties": {"status": "planned", "priority": "1"}}], "folder_id": "optional-folder-uuid"}Example Response
{"success": true, "operation_count": 1, "versions": [42], "created": [{"kind": "node", "id": "9f0c...", "label": "OAuth Integration", "auto_id": "REQ-42"}], "created_nodes": [{"id": "9f0c...", "label": "OAuth Integration"}]}This content was written collaboratively with AI.