update_tags

mutationSince v1.0

Set 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.