Changelog

July 25, 2026

v2.0.9 — Entities API, SDK/CLI coverage, ChatGPT MCP connector, and client cleanup

This release publishes the Entities API in the docs and SDKs, ships a ChatGPT MCP connector, expands the MCP tool surface, and removes an experimental workflow method from the public clients.

Added

  • Entities API (public): Reusable characters, products, and visual styles are now part of the published REST surface (x-fern-audiences: rest) and the hosted API reference. Create and manage them with:
    • GET / POST /v1/entities (list / create; filter list by entityType: ACTOR | PRODUCT | VISUAL_STYLE)
    • GET /v1/entities/{entityId}
    • POST /v1/entities/{entityId}/update
    • POST /v1/entities/{entityId}/archive
    • POST /v1/entities/{entityId}/references and POST /v1/entities/{entityId}/references/remove (attach or detach reference images uploaded via POST /v1/files/upload) Entity ids use the vg_enti_... prefix. Use an entity in a workflow with visualStyle: { type: "ENTITY", entityId } (for VISUAL_STYLE) or the structured storyboard attachment fields where available.
  • Entities in the TypeScript, Python, and CLI clients: @videogen/sdk, videogen, and @videogen/cli expose an entities resource with listEntities, createEntity, getEntity, updateEntity, archiveEntity, addEntityReference, and removeEntityReference (CLI: videogen entities …).
  • MCP and ChatGPT: The hosted MCP server advertises 37 tools (workflows, media tools, projects, files, entities, assistant, resources, account). Connect ChatGPT in developer mode to https://mcp.videogen.io/mcp and sign in with VideoGen OAuth (Dynamic Client Registration); see MCP server. The published ChatGPT app tool surface is pinned to this MCP version.
  • Docs parity: llms.txt and the API reference now list the Entities endpoints, Assistant routes, timeline interchange, supported languages, and assistant_message.* webhook events alongside the existing workflow, tool, file, and account pages. Export docs document both watermarkMode and endScreenMode (set both to NONE with the Production API add-on to drop VideoGen branding).

Changed

  • Breaking (SDKs / CLI only): contentOutlineToVideo removed from the public clients. TypeScript, Python, and the CLI no longer expose contentOutlineToVideo / content_outline_to_video / content-outline-to-video. That workflow remains an experimental HTTP route (POST /v1/workflows/content-outline-to-video, internal audience) and is not part of the published REST reference. Prefer POST /v1/workflows/prompt-to-video-clip or a narrated workflow such as script-to-video. Call sites that imported the removed methods need to switch workflows or call the HTTP path directly.
  • Fix: API key creation when no team is selected. Creating a developer API key no longer fails when the account’s denormalized selected-team field is null. Key creation always attributes to the request’s resolved active team (falling back to the personal team when needed).