> ## Documentation Index
> Fetch the complete documentation index at: https://docs.babou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ExportProject

> Export a video project to a downloadable file via MCP

## Overview

Exports a complete video project to a downloadable MP4 file. All chapters are rendered and combined into a single video.

<Info>
  **Processing time:** Exports typically take 2-5 minutes depending on project complexity.
</Info>

## Parameters

<ParamField path="project_id" type="string" required>
  The project ID to export (e.g., `prj_abc123xyz`)
</ParamField>

## Returns

Returns the export job status. Check back periodically to get the download URL.

## Example Usage

### In Claude

```
Export my Product Demo project
```

```
I'm done with the edits - export the project to video
```

```
Export project prj_abc123xyz and let me know when it's ready
```

### Direct Tool Call

```json theme={null}
{
  "name": "ExportProject",
  "arguments": {
    "project_id": "prj_abc123xyz"
  }
}
```

### Response (Started)

```json theme={null}
{
  "status": "queued",
  "message": "Export started",
  "estimated_time": "2-5 minutes"
}
```

### Response (After Completion)

```json theme={null}
{
  "status": "completed",
  "download_url": "https://assets.babou.ai/exports/prj_abc123xyz.mp4",
  "started_at": "2025-12-02T10:05:00Z",
  "completed_at": "2025-12-02T10:08:00Z",
  "duration_seconds": 180
}
```

## Common Use Cases

<AccordionGroup>
  <Accordion title="Final export" icon="check">
    ```
    My video is complete - export it so I can download it
    ```
  </Accordion>

  <Accordion title="Check export status" icon="spinner">
    ```
    Is my export ready yet?
    ```

    Claude will check the status and let you know when it's done.
  </Accordion>

  <Accordion title="Download after completion" icon="download">
    ```
    Export my project and give me the download link
    ```

    Claude will start the export and provide the URL once ready.
  </Accordion>
</AccordionGroup>

## Before Exporting

Make sure:

* ✓ All chapters have been created
* ✓ All prompts have completed processing
* ✓ You've reviewed the content

<Warning>
  Only completed chapters will be included in the export. Chapters without content or with failed prompts will be skipped.
</Warning>

## Workflow Example

### In Claude

```
User: Create a product video with intro, features, and outro chapters

Claude: [Creates project, adds chapters, submits prompts]

User: Export the project

Claude: [Starts export, waits for completion]
Claude: Your video is ready! Download it here: [URL]
```

## Export States

The export can be in one of these states:

| State        | Description                                          |
| ------------ | ---------------------------------------------------- |
| `queued`     | Export is queued and waiting to start                |
| `processing` | Export is actively being rendered                    |
| `completed`  | Export finished successfully, download URL available |
| `failed`     | Export failed, error message provided                |

## Download the Video

Once the export status is `completed`, you can download the video from the `download_url`:

```
The video is ready at: https://assets.babou.ai/exports/prj_abc123xyz.mp4
```

<Tip>
  Download URLs are temporary. Download your video promptly after the export completes.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Export takes too long" icon="clock">
    Complex projects with multiple chapters and effects take longer to render. Wait patiently or check the status after a few minutes.
  </Accordion>

  <Accordion title="Export fails" icon="triangle-exclamation">
    Common causes:

    * No completed chapters in the project
    * Corrupted prompts or assets
    * Server issues

    Try checking chapter status and retry the export.
  </Accordion>

  <Accordion title="Can't find download URL" icon="link">
    The download URL is only available when status is `completed`. Keep checking the export status until it finishes.
  </Accordion>
</AccordionGroup>

## REST API Equivalent

This tool calls:

1. `POST /api/v1/projects/{projectId}/export` (start export)
2. `GET /api/v1/projects/{projectId}/export` (check status)

See the [Export API documentation](/api-reference/exports/start) for more details.