---
title: "Get video upload URL"
method: POST
path: "/uploads/video/get_upload_url"
tags: ["Uploads"]
---

# Get video upload URL

`POST /uploads/video/get_upload_url`

## Request

- Base URL: `https://api.mosaic.so`
- URL: `https://api.mosaic.so/uploads/video/get_upload_url`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Get a pre-signed URL for video upload. Use this to upload videos for node parameters. Max 5GB, 1 hour duration. After uploading, call `/uploads/video/finalize_upload` to get the video UUID.

## Response `200`

Upload URL generated successfully

- VideoUploadUrlResponse
  - `video_id` string: UUID for the video. Use this to call finalize_upload and in update_params.
  - `upload_url` string: URL to POST the file to
  - `upload_fields` object: Form fields to include before the file in the POST request
  - `max_file_size_bytes` integer: Maximum file size (5GB)

## Other responses

- `401`: Authentication failed

---

[API](https://skmtc.dev/mosaic/apis/mosaic-ai-api.md) - [All operations](https://skmtc.dev/mosaic/apis/mosaic-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mosaic/apis/mosaic-ai-api/revisions/c20e9fc606a4?raw)