Skip to main content

​
Mosaic API

Mosaic provides a powerful API for automating professional-grade video editing with AI-powered agents. Upload videos, run pre-built workflows, and receive polished outputs programmatically.

​
Base URL

https://api.mosaic.so

​
Core Concepts

​
Agent

A pre-built video editing workflow that can be executed via the API. Create and configure agents at app.mosaic.so.

​
Agent Run

An execution instance of an agent that processes your videos. Track progress and retrieve outputs through the run ID.

​
Video Upload

A 3-step process using pre-signed URLs for efficient, direct-to-cloud uploads.

​
Triggers

Automated agent execution based on external events (e.g., new YouTube videos).

​
API Overview

Video Upload

3-step process for uploading videos

Agent Operations

Run agents and track their progress

Triggers

Automate agents with YouTube monitoring

Webhooks

Receive real-time status updates

​
Authentication

All API requests require authentication using an API key prefixed with mk_. 
curl -H "Authorization: Bearer mk_your_api_key" \
     https://api.mosaic.so/agent/[agent_id]/run
Test your API key with the /whoami endpoint: 
curl -H "Authorization: Bearer mk_your_api_key" \
     https://api.mosaic.so/whoami

​
Next Steps

Start with the API Introduction for authentication details and conventions, then explore each endpoint category.