Shotstack

Combine Videos Shotstack

Combine multiple public video URLs into one render job in source order. Use for simple concatenation only — submit a full timeline render for effects, transitions, overlays, or multi-track timelines.

Crop Video Shotstack

Crop a public video URL and submit an async render job.

Shotstack Delete Asset

Permanently delete a hosted CDN asset by asset_id. Renders cannot be deleted — only individual asset files.

Shotstack Delete Source

Permanently delete an ingested source file by source_id.

Shotstack Delete Template

Permanently delete a Shotstack template by template_id. Cannot be undone.

Shotstack Generate Asset

Start an async AI asset generation job (text-to-image, text-to-speech, image-to-video, text-generator). Returns asset_id and poll_with — poll generated-asset status until done, then use the URL in a render timeline or as a standalone file.

Shotstack Get Asset

Get a hosted Shotstack CDN asset by asset_id (from get_assets_by_render or render output). Also accepts transfer_id or render_id and resolves the hosted file when direct lookup 404s.

Shotstack Get Assets By Render

List CDN assets generated for a render_id. A single render may produce multiple files (video, thumbnail, poster). Use after render status reports done when you need per-file CDN metadata.

Shotstack Get Generated Asset

Poll an AI generation job started via the Create API. Returns status and output URL when ready.

Shotstack Get Render

Get async render status (queued, rendering, done, failed) and the output video URL when complete. When status is done, also returns hosted CDN assets (video, thumbnail, poster) so one poll call is enough. Poll every few seconds until status is done or failed.

Shotstack Get Sources

List Shotstack ingested sources or fetch one by source_id. Sources move queued → ingesting → ready (or failed). Poll source_id after starting an ingest job until status is ready.

Shotstack Get Templates

List Shotstack templates or fetch one template by template_id. List mode returns id, name, and timestamps; single mode returns the full timeline JSON needed for edits and renders.

Shotstack Ingest Source

Ingest media from a public URL into Shotstack storage for use in renders. Returns source id — poll source listing or single-source fetch until status is ready.

Shotstack Inspect Media

Inspect a public media URL via Shotstack probe (ffprobe). Returns duration, format, width, and height — probe before combine or crop convenience renders when clip length matters.

Shotstack Render Template

Render video from a saved template by merging data with placeholders. Templates are pre-configured timelines with {{variable}} placeholders. Returns render id — poll render status until status is done.

Shotstack Render Video

Submit a video editing timeline for rendering. Accepts timeline JSON including combining, cropping, effects, transitions, and text overlays. Returns render_id — poll render status until status is done. Rendering is asynchronous.

Shotstack Search

Filter templates or ingested sources after listing — not for renders or CDN assets. Query must mention templates or sources (e.g. 'ready sources', 'list templates'). For a known render_id use render status; for CDN files use hosted asset lookup.

Shotstack Transfer Asset

Import a file from a public URL onto Shotstack CDN (Serve API). Returns transfer_id — poll assets-by-render until ready, then use assets[0].asset_id with hosted asset lookup.

Shotstack Upsert Template

Create or update a Shotstack template. Omit id to create; pass id to update. Templates are reusable timelines with {{variable}} merge placeholders.

Shotstack Wait For Generated Asset

Poll a Shotstack Create API generation job until status is done or failed (or times out). Returns the final asset payload including output URL when ready. Use after shotstack_generate_asset.

Shotstack Wait For Ingest

Poll a Shotstack ingest job until status is ready or failed (or times out). Returns the final source payload including the processed URL when ready. Use after shotstack_ingest_source.

Shotstack Wait For Render

Poll a Shotstack render job until status is done or failed (or times out). Returns the final render payload including output URL and CDN assets when done. Use after submit tools that return a render_id.

Shotstack Wait For Transfer

Poll a Shotstack Serve transfer until hosted assets are ready or failed (or times out). Returns assets with asset_id values for shotstack_get_asset. Use after shotstack_transfer_asset with the returned transfer_id.