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 edit.mosaic.so.

​
Agent Run

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

​
Triggers

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

​
API Overview

Agents

Create and inspect agent templates

Agent Runs

Execute agents and monitor progress

Node Types

Discover available node type IDs

Triggers

Automate agents with YouTube monitoring

Webhooks

Receive real-time status updates

Asset Management

Upload and fetch signed view URLs for media

Credits

Check credit balances

Plan

Inspect plans, pricing tiers, and upgrades

Social

Connect platforms and publish social posts

​
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.