Public API v1

A media-aware API for creating and queueing content.

Use ClutchCut from your own application or automation workflow: discover source media, start generation jobs, inspect results, approve outputs, and move finished content toward the social queue. API access is currently intended for approved early-access accounts.

The first API workflow

Keep orchestration in your system while ClutchCut handles the media-aware production steps.

01

Discover media

02

Start a job

03

Review outputs

04

Queue approved work

Quick start

This example starts a video generation job from an existing media asset. Use an API token with the minimum scopes your workflow needs.

Generate a videoPOST
curl -X POST "$CLUTCHCUT_API_BASE_URL/api/v1/generate/video" \
  -H "Authorization: Bearer $CLUTCHCUT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "media_ids": ["media-id"],
    "topic": "Three ways to use the product",
    "format": "explainer",
    "duration": 45,
    "platform_target": "general",
    "visual_source_policy": "owned_media_only"
  }'

The API accepts public v1 routes for generation, jobs, media, videos, carousels, social accounts, queue items, scheduling, and queue batches. Content Kit and source-package routes are still being finished.

Core endpoints

GET
/api/v1/media

Discover source media

List and inspect the footage and images available to your workflow.

POST
/api/v1/generate/video

Generate a video

Create a job grounded in selected media, a topic, and a target format.

POST
/api/v1/generate/carousel

Generate a carousel

Create a carousel job from the same source-aware media workflow.

GET
/api/v1/jobs/{job_id}

Inspect the job

Poll a generation job and retrieve linked video or carousel IDs.

POST
/api/v1/social/queue

Queue approved content

Create a queue item or batch with destination and caption metadata.

Documentation follows the contract.

We are keeping the public API docs, MCP adapter, and product behavior aligned before promoting this as a broad automation platform.

Build your workflow around a source of truth.

The API is designed to keep your media, generation state, approvals, and queue actions traceable as your content operation grows.

Request early access