# Shotstack AI integration on Definable

> Shotstack is a cloud-based platform that enables developers, marketers, and designers to automate the generation of videos, images, and audio at scale using a RESTful API.

## What this connects

Shotstack is a cloud-based platform that enables developers, marketers, and designers to automate the generation of videos, images, and audio at scale using a RESTful API.

Vendor: https://shotstack.io/

## Tools available

**23** tools available. First 12:

- `SHOTSTACK_CREATE_TEMPLATE` — Create Template — Tool to create a new template for video editing. Use when you want to save a reusable timeline configuration as a template. Template changes do not retroactively affect past renders.
- `SHOTSTACK_CREATE_TEMPLATE2` — Create Template (v2) — Tool to save an Edit as a re-usable template. Templates can be retrieved and modified before rendering. Use when you want to create a template with merge fields for dynamic content.
- `SHOTSTACK_DELETE_INGESTED_MEDIA` — Delete Ingested Media — Tool to delete an ingested media asset. Use when you've confirmed the ingest ID and need to remove the file from Shotstack storage.
- `SHOTSTACK_DELETE_TEMPLATE2` — Delete Template — Tool to delete a specific Shotstack template by its ID. Use when you need to remove a template permanently.
- `SHOTSTACK_DELETE_WORKFLOW` — Delete Shotstack Workflow — Tool to delete a specific Shotstack workflow. Use when you need to permanently remove a workflow after confirming its ID.
- `SHOTSTACK_FETCH_SOURCE` — Fetch Source — Tool to fetch a remote media file and store it as a source asset. Operation is asynchronous — poll SHOTSTACK_GET_INGEST_STATUS or SHOTSTACK_INSPECT_MEDIA until the asset is ready before passing it to SHOTSTACK_RENDER_VIDEO or other downstream tools. Use when you need to ingest a file before rendering.
- `SHOTSTACK_GET_ASSETS` — Get Asset — Tool to fetch details of a hosted asset by its unique identifier. Use when you need to retrieve information about videos, images, audio files, thumbnails, or poster images hosted on Shotstack's CDN.
- `SHOTSTACK_GET_ASSETS_RENDER` — Get Assets by Render ID — Tool to retrieve hosted assets by render ID. Use when you need to fetch one or more files (video, thumbnail, poster image) generated by a specific render job.
- `SHOTSTACK_GET_INGEST_STATUS` — Get Ingest Status (Deprecated) — DEPRECATED: Use SHOTSTACK_GET_SOURCE instead. Tool to retrieve the status and details of an ingested media asset. Poll until the asset status is 'ready' before using it in SHOTSTACK_RENDER_VIDEO; rendering against an unprocessed asset causes missing clips or failed renders.
- `SHOTSTACK_GET_RENDER_CALLBACK` — Get Render Callback — Tool to retrieve the webhook/callback URL configuration for a specific render job. Returns only callback settings (URL, method, headers), not render status or output URLs — use a separate render-status check to obtain final results.
- `SHOTSTACK_GET_RENDER_STATUS` — Get Render Status — Tool to retrieve the current status and details of a Shotstack render job by render ID. Use when polling a render until done or failed, typically after creating a render with SHOTSTACK_RENDER_VIDEO.
- `SHOTSTACK_GET_SOURCE` — Get Source Details — Tool to fetch the details of a specific source asset. Use when you need to inspect a source after uploading, check its status, or diagnose ingest/render failures—such as unsupported codecs, corrupt files, or bad URLs—before retrying.

## Auth

Auth schemes: `API_KEY`.

## How agents use Shotstack

Inside a Definable workflow, Shotstack is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Shotstack** — the Researcher (GPT-5.5) pulls context from Shotstack (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Shotstack** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Shotstack (create record, post message, draft email).
- **Designer / Engineer → Distributor → Shotstack** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Shotstack (attach file, open PR comment, post status).

The Verifier checks every Shotstack call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- video & audio — https://definable.ai/apps/category/video-&-audio/
- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/shotstack/
- Same category (video & audio): https://definable.ai/apps/category/video-&-audio/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt