update_tags
mutationSince v1.0Set the tags on a model element. This REPLACES every tag already on the element, so read its current tags first and send them back alongside the new ones — otherwise you silently drop the tags that were there. Tags come back from search_nodes, get_node_details, get_relationships, get_metamodel and the list_ tools; list_tags shows the vocabulary already in use.
Works on any taggable element: node, relationship, node_type, relationship_type, diagram, grid_view, folder, filter, tree, rendering, publication, asset, twin, scenario, agent, simulation_diagram. (Simulation links are the one exception — they carry no tags.)
Applied immediately.
Example Request
{"item_type": "node", "item_id": "uuid-or-REQ-1", "tags": ["important", "reviewed"]}Example Response
{"success": true, "operation_count": 1, "versions": [60]}This content was written collaboratively with AI.