Skip to navigation

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.