create_tree

mutationSince v1.0

Create a navigation tree (ModelTree): a named, ordered tree structure over the graph, used as a reading-oriented browse structure (Reader Workspace, publishing site nav, report chapter order). A tree is an ordered list of branches; each branch may have a label, description, a seed (a filter expression selecting its node(s) — e.g. {"OfType":{"type_id":""}}, {"HasId":{"ids":[""]}}, {"FilterRef":{"filter_id":""}}), an expansion (follow a relationship from the seed), an ordering, and nested children. Use list_trees to discover existing trees. Applied immediately.

Example Request

{"name": "Reading Order", "description": "How to read this model", "branches": [{"label": "Capabilities", "seed": {"OfType": {"type_id": "node-type-uuid"}}, "expansion": {"matcher": {"relationship_type_ids": ["contains-rel-uuid"], "direction": "Outgoing"}, "max_depth": 3}}], "folder_id": null}

Example Response

{"success": true, "operation_count": 1, "versions": [88]}