create_nodes
mutationSeit 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.
Parameter
| Name | Typ | Pflichtfeld | Standard | Beschreibung |
|---|---|---|---|---|
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. |
Beispielanfrage
{"nodes": [{"node_type": "Feature", "label": "OAuth Integration", "description": "Add OAuth 2.0 support", "properties": {"status": "planned", "priority": "1"}}], "folder_id": "optional-folder-uuid"}Beispielantwort
{"success": true, "operation_count": 1, "versions": [42]}