update_tags
mutationSince v1.0Change an element's tags. Use add and remove for the usual case: they need no prior read and can't lose someone else's tagging. tags replaces the whole list, so read the current tags first and send them back with the new ones. Exactly one of tags or add/remove is needed. 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": "REQ-1", "add": ["reviewed"]}Example Response
{"success": true, "operation_count": 1, "versions": [60]}This content was written collaboratively with AI.