Edit footage
Submit a headless footage edit. Accepts the same request as the dashboard and MCP editor. The edit is asynchronous; poll GET /v1/jobs/ or subscribe through the job stream token.
Authorizations
A workspace API key.
Headers
Optional durable retry key. Reuse only for the identical logical request; a different payload returns conflict.
1 - 255Body
Existing project that owns the source media and finished edit.
1 - 200Stable id grouping the clips of one shoot.
1 - 120Storage ids of the source clips to edit.
1 - 200 elements1Title or editorial brief name.
1 - 200Optional editorial direction.
4000Produce a long-form cut.
Number of short-form outputs to create; 0 means no shorts.
0 <= x <= 10Optional platform target for the long-form output, for example youtube or instagram.
Optional platform target for all short-form outputs.
Optional length of each short, in whole seconds (15-90). Omit to let the editor choose.
15 <= x <= 90Optional saved composition in the project to lay the cut out on; send with compositionRevisionId.
1 - 200The composition revision the caller reviewed; a stale revision answers 409 conflict.
1 - 200Optional editor policy. Every field you omit takes the workspace's edit default (Settings, Edit defaults), else Sigmora's: captions and on-screen visuals on (founder-teleprompter vocabulary, standard density, figures fact-checked), standard cleanup, transcript-reading intelligence, cold open on, automatic pacing, subtle punch-in, no music bed. A field you send always wins, false included.
Optional ContentBrand id used for packaging and metadata.
1 - 120When true, stop after the proposal for human or API approval; defaults false.
Optional evidence for document cards: up to 8 Library images (screenshots, documents), each with an optional caption of up to 120 characters.
8Schedule the whole pack (the long cut and every finished short) on a YouTube channel automatically once every output has finished, on the pack cadence and through the workspace approval policy. What failed or was skipped is left out and the rest still goes out. Free; the edit is billed as usual. Never sets the AI-disclosure label.
Public HTTPS URL for signed terminal job-event callbacks.
At least 32 characters; verifies the signed callback envelope.
32 - 512