List C4D Entities
list_entitiesEnumerate Cinema 4D scene entities by kind (objects, materials, tags, etc.) with filters and compact summaries, enabling targeted inspection before modifying parameters.
Instructions
Enumerate scene entities of a given kind. Returns compact summaries (name, type_id, type_name, plus kind-specific fields — is_active for take / material / render_data). For kind=object also supports type_ids / tag_types / max_depth filters and include_tags / include_params to read data inline — so you can find 'all cubes with a Ttexture tag and their position in one call' without falling back to exec_python. Use this first to find what exists before describe/set_params. Note: kind=shader walks classical shader chains; for node-material graphs use list_graph_nodes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Entity kind to list. | |
| owner | No | Owner handle (required for kind=shader). | |
| object | No | Filter tags to this object name (only for kind=tag). Omit to list tags on all objects. | |
| type_ids | No | (kind=object) Keep only objects whose GetType() is in this set (e.g. [5159] for cubes). | |
| max_depth | No | (kind=object) Skip objects deeper than this (root=0). Default: unlimited. | |
| tag_types | No | (kind=object) Keep only objects carrying a tag whose type id is in this set (e.g. [5616] for Ttexture). | |
| object_path | No | Filter tags to this object path (only for kind=tag). Use when the name is not unique. | |
| render_data | No | Render data name (required for kind=video_post). | |
| include_tags | No | (kind=object) Attach `tags: [{type_id, type_name, name}, ...]` to each match. | |
| name_pattern | No | Optional regex to filter results by name (e.g. "^VFX_Shot00[2-9]$"). | |
| include_params | No | (kind=object) Parameter ids to read per match. Returned under `params: {param_id: value}`. |