list_folders

readSince v1.0

List the model's folders. Each one comes back with its id, name, which layer it belongs to (the metamodel or the model itself), what kind of content it holds, and its parent folder. Use this to look up a folder before calling anything that takes a folder_id — create_nodes, add_node_type, move_to_folder, create_diagram, create_filter, create_asset.

Parameters

NameTypeRequiredDefaultDescription
layerStringRestrict to folders in one layer: 'metamodel' for the folders holding your types, 'model' for those holding the elements themselves.
localeStringReturn folder names and descriptions in this language (for example 'de').
content_typeStringRestrict to folders holding one kind of content — for example 'nodes', 'node_types', 'relationships', 'filters' or 'assets'.

Example Request

{"layer": "model", "content_type": "nodes"}

Example Response

{"total_count": 2, "folders": [{"id": "1de8...", "name": "Risks", "layer": "model", "content_type": "nodes", "parent_folder_id": null}]}

This content was written collaboratively with AI.