Find control nodes by type or title
singular_find_nodesRead-onlyIdempotent
Search all control nodes across compositions filtered by type or title substring. Locate image or text nodes quickly without manually parsing the model tree.
Instructions
Search all control nodes across the app's compositions, filtered by type and/or title substring. E.g. type='image' locates every fillable image node (the common newsroom case), type='text' for headlines. Saves hand-parsing the model tree.
Args: app/appToken; type (optional, e.g. 'image'); title_contains (optional); response_format. Returns { count, nodes: [{ subCompositionId, subCompositionName, id, title, type }] }.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | Alias of a registered app instance (see register_app / list_apps). Preferred over a raw token. | |
| type | No | Filter to a control-node type, e.g. 'image'. Common types: text, textarea, number, image, color, checkbox, audio, json, timecontrol, button (newer types like 'selection' are also accepted). | |
| appToken | No | Raw Singular control-app token for a one-off/unregistered instance. If both 'app' and 'appToken' are given, 'appToken' wins. | |
| title_contains | No | Case-insensitive substring match on the node title. | |
| response_format | No | Output format: 'markdown' (human-readable) or 'json' (machine-readable). Default 'markdown'. | markdown |