update_nodes

mutationSince v1.0

Update labels, descriptions, or properties on existing nodes. Use set_label/set_description to update core fields, set_properties for key-value pairs, and remove_properties to clear values. Node IDs accept both UUIDs and auto-IDs (e.g. REQ-42).

Parameters

NameTypeRequiredDefaultDescription
updatesArray<Object>[update_nodes] Array of update objects. Each must have node_id (required, UUID or auto-ID). Optional fields: set_label, set_description, set_properties (object), remove_properties (array of names). Required.

Example Request

{"updates": [{"node_id": "uuid-1", "set_label": "OAuth 2.0 Integration", "set_properties": {"status": "in-progress"}, "remove_properties": ["legacy_field"]}]}

Example Response

{"success": true, "operation_count": 3, "versions": [43, 44, 45]}