List story elements
list_entitiesRead-onlyIdempotent
List the project's story entities (characters, places, objects) in the order the user arranged them. Each has entityId, kind, name, slug, color and referenceHandle (write it in a shot's actionText to show the entity in that shot). entityId is what script elements carry as characterId / placeId (see get_scene) and what scene headings link as placeId in get_project_outline. Filter with kind; set includeDescriptions to also return each entity's description text (empty string when none).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Only return entities of this kind. | |
| projectId | Yes | ScreenWeaver project id (from list_projects). | |
| includeDescriptions | No | Include each entity's description text (slower; default false). |