> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.videogen.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.videogen.io/_mcp/server.

## v2.3.5 — Brand, location, and prop entities

The Entities API has three new entity types. Use `LOCATION` for a place or set you want to keep consistent across scenes, `PROP` for a background object that is not something you sell, and `BRAND` to hold a logo, a style guide image, and a writing style. Keep using `PRODUCT` for anything you sell or promote.

### Added

- **`BRAND`, `LOCATION`, and `PROP` entity types:** `POST /v1/entities` accepts the new `entityType` values, `GET /v1/entities?entityType=…` filters by them, and `Entity.entityType` can return them. The TypeScript SDK, CLI (`videogen entities list-entities --entity-type …`), and MCP `create_entity` / `list_entities` tools accept the same values.
- **Brand configuration:** Set `brandConfig` with `fonts`, `colors`, and `writingStyle` when creating a `BRAND` entity. Include the complete `brandConfig` when updating it. `fonts` and `colors` accept up to 1,000 characters, `writingStyle` up to 1,500, and unknown fields are rejected. Entity responses return the saved configuration.
- **Reference roles:** `POST /v1/entities/{entityId}/references` accepts an optional `role`. Use `BRAND_LOGO` for a brand's overlay logo or `BRAND_STYLE_GUIDE` for its style guide image; attaching one replaces the brand's previous logo or style guide. Other references use the default, `REFERENCE`. Both brand roles are rejected on other entity types. Every entry in `Entity.references` now returns its `role`.