> 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.2.0 — Auto-export after a workflow run

Workflow start requests can now render an MP4 before the run is marked succeeded. Set `autoExport: true` (REST and SDK default is still `false`). MCP workflow tools default `autoExport` to `true`. Zapier, Make, n8n, and Pipedream always auto-export (the field is not shown) and wait until the MP4 is ready. When auto-export is on, wait until `status` is `succeeded` and use `downloadUrl`. Remix actions on the same start request finish before that export.

### Added

- **`autoExport` and `exportOptions` on workflow starts:** All five workflow start bodies accept `autoExport` and optional `exportOptions` (same shape as `POST /v1/projects/{projectId}/export`). Omitted export fields use the same defaults as a standalone export.
- **Export fields on `WorkflowRun` and `workflow_run.*` webhooks:** `exportId`, `downloadUrl`, `downloadUrlExpiresAt`, `exportFileId`, `thumbnailUrl`, and `thumbnailUrlExpiresAt` are always present. They are `null` until an auto-export succeeds.
- **MCP default:** Workflow tools (`script_to_video`, `voiceover_to_video`, `slideshow_to_video`, `storyboard_to_video`, `prompt_to_video_clip`) default `autoExport` to `true`. Pass `false` only if you will remix and export yourself.
- **Zapier, Make, n8n, and Pipedream:** Auto-export is always on. Each action waits until the run succeeds, then returns `projectId`, `projectUrl`, `downloadUrl`, and `thumbnailUrl`.

### Fixed

- **File upload:** `POST /v1/files/upload` no longer errors before the upload URL is issued. SDK `createFileUpload` and MCP `create_file_upload` / `upload_file` are the same.
- **Workflow `aspectRatio`:** Script-to-video, voiceover-to-video, slideshow-to-video, storyboard-to-video, and prompt-to-video-clip apply the `aspectRatio` you send (including 9:16) to the generated project. `GET /v1/projects/{projectId}` returns that ratio.
- **Video clip generation:** `POST /v1/tools/generate-video-clip` and storyboard scene clips are less likely to fail when a generation job is retried.