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 |
|---|---|---|---|---|
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. | |
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. |
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]}