search_nodes

readSeit v1.0

Search for nodes (instances) in the model. Filter by type, name, description, property values, or folder. Returns summaries — use get_node_details for full information.

Parameter

Name	Typ	Pflichtfeld	Standard	Beschreibung
`folder_id`	`String`	—		[search_nodes] Restrict results to nodes inside this folder (UUID).
`locale`	`String`	—		[search_nodes] Optional locale code (e.g. 'de', 'en') to return translated labels and descriptions.
`offset`	`Number`	—	0	[search_nodes] Skip the first N results for pagination.
`properties`	`Object`	—		[search_nodes] Filter by property values. Keys are property names, values are match expressions (substring match).
`name_contains`	`String`	—		[search_nodes] Return only nodes whose label contains this text (case-insensitive).
`description_contains`	`String`	—		[search_nodes] Return only nodes whose description contains this text.
`node_type`	`String`	—		[search_nodes] Filter results to nodes of this type name (case-insensitive match against metamodel type names).
`limit`	`Number`	—	50	[search_nodes] Maximum number of results to return. Default: 50, max: 200.

Beispielanfrage

{"node_type": "Feature", "properties": {"status": "planned"}, "limit": 50}

Beispielantwort

{"total_count": 12, "nodes": [{"id": "uuid-1", "label": "OAuth Integration", "type": "Feature", "preview": "status: planned, priority: 1"}]}