Authentication

Authenticate requests with your BlitzReels API key.

All requests require a live API key.

Send it as a Bearer token in the Authorization header:

Header

-H "Authorization: Bearer br_live_..."

API keys are tied to a workspace and inherit its plan limits.

Validate a Key

Use this before debugging endpoint paths or project IDs:

Terminal

curl https://www.blitzreels.com/api/v1/auth/validate \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"

The response includes the workspace, user, environment, plan, key prefix, and current agent-skill guidance.

Go to:

Dashboard → Workspace → AI → API Keys

Only owners/admins can create keys. Keys are shown once.

If a key is missing or invalid, the API returns authentication_error.

Quickstart

Create and export your first short-form clip from a YouTube URL or workspace asset.

Core Concepts

Projects, media assets, timeline items, jobs, and exports in the BlitzReels API.