search_nodes

LesenSeit v1.0

Sucht nach Knoten (Instanzen) im Modell. Filtern Sie nach Typ, Name, Beschreibung, Eigenschaftswerten oder Ordner. Gibt Zusammenfassungen zurück – für vollständige Informationen verwenden Sie get_node_details. Jede Zusammenfassung enthält jetzt einen updated_at-Zeitstempel (ISO 8601 UTC) zur Änderungserkennung.

Parameter

NameTypPflichtfeldStandardBeschreibung
folder_idString[search_nodes] Ergebnisse auf Knoten innerhalb dieses Ordners beschränken (UUID).
localeString[search_nodes] Optionaler Gebietsschema-Code (z. B. 'de', 'en') für übersetzte Labels und Beschreibungen.
offsetNumber0[search_nodes] Die ersten N Ergebnisse für die Paginierung überspringen.
propertiesObject[search_nodes] Nach Eigenschaftswerten filtern. Schlüssel sind Eigenschaftsnamen, Werte sind Suchausdrücke (Teilstring-Abgleich).
name_containsString[search_nodes] Nur Knoten zurückgeben, deren Label diesen Text enthält (Groß-/Kleinschreibung wird ignoriert).
description_containsString[search_nodes] Nur Knoten zurückgeben, deren Beschreibung diesen Text enthält.
node_typeString[search_nodes] Ergebnisse auf Knoten dieses Typnamens filtern (Groß-/Kleinschreibung wird beim Abgleich mit Metamodell-Typnamen ignoriert).
limitNumber50[search_nodes] Maximale Anzahl zurückgegebener Ergebnisse. Standard: 50, Maximum: 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", "updated_at": "2026-06-11T10:30:00Z"}]}