Shotstack
video & audio 24 tools availableShotstack 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.
About this integration
Connect Shotstack to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Shotstack's 24 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Connect Shotstack to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.
Shotstack · in workflows
What teams actually run.
Three patterns teams run with Shotstack on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.
Daily summary
Cross-tool sync
24 tools available
The Shotstack toolbox.
Every Shotstack capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.
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.
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.
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.
Delete Template Tool to delete a specific Shotstack template by its ID. Use when you need to remove a template permanently.
Delete Shotstack Workflow Tool to delete a specific Shotstack workflow. Use when you need to permanently remove a workflow after confirming its ID.
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.
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.
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.
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.
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.
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.
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.
Get Template Tool to retrieve details of a specific template. Use when you have the ID of an existing template and need its metadata.
Get Template By Version Tool to retrieve a template by template id and API version. Use when you need to fetch template details from a specific Edit API version.
Get Upload URL Tool to request a signed URL for direct file upload to Shotstack. Use when you need to upload a file to Shotstack storage. The response returns a signed URL that you use to upload the file using a PUT request with the binary file.
Inspect Media Tool to inspect media metadata. Use before rendering to retrieve duration, resolution, frame rate, and format of an online media file — clip timecodes, trim points, and audio sync calculations depend on these values. Mixing assets without prior inspection can cause letterboxing, jitter, or audio sync issues in the final output.
List Sources Tool to list all source assets. Use when you need to retrieve source entries with optional pagination.
List Sources (with Environment) Tool to list all ingested source files with environment selection. Use when you need to retrieve sources from stage (sandbox) or v1 (production) environment with optional pagination.
List Templates Tool to list all Shotstack templates for the account. Use after creating or updating templates to view your available templates.
List Templates with Environment Tool to list all Shotstack templates for the specified environment. Use when you need to retrieve templates from a specific environment (stage or production).
Request Upload URL Tool to request a signed URL for direct file upload. Use when you need to upload a file to Shotstack storage. The response returns a signed URL that expires in one hour.
Render Video Tool to initiate a new video render job. Use when you have defined a timeline and output settings and want to start rendering.
Transfer Asset Tool to transfer a file from any publicly available URL to one or more Serve API destinations. Use when you need to copy a file from an external source to Shotstack's hosting service or other configured destinations.
Update Template Tool to update an existing template by its ID. Use when you need to modify a template's name or edit configuration. Both name and complete template definition must be provided.
See it run
One prompt, start to finish.
A real prompt, the Shotstack tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.
Run a real Shotstack task end-to-end — plan it, execute across the API, and hand back a verified result.
shotstack.create_template Tool to create a new template for video editing. Use when you want to save a reusable time shotstack.create_template_v2 Tool to save an Edit as a re-usable template. Templates can be retrieved and modified befo shotstack.delete_ingested_media Tool to delete an ingested media asset. Use when you've confirmed the ingest ID and need t · verified Done. Shotstack responded across 3 calls, the verifier signed off, and the result is logged with every payload.
FAQ · Shotstack
Questions, answered.
What teams ask before connecting Shotstack.
01 What can I automate with Shotstack on Definable?
Anything Shotstack exposes through its API. Common video & audio workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 24 Shotstack tools directly, then chain the result into another integration without you writing code.
02 How does Shotstack authentication work?
Shotstack uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
03 Is the Shotstack integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 24 Shotstack tools. You only need a separate Shotstack subscription if Shotstack itself charges per seat or per API call.
04 Is using Shotstack through Definable secure?
Every call from a persona to Shotstack is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
05 How do I get started with Shotstack on Definable?
Sign up for Definable, open the integrations page, find Shotstack, and connect via OAuth or API key. You can immediately attach Shotstack to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
06 What Shotstack actions does Definable expose?
Definable exposes all 24 Shotstack actions as callable tools — including `Create Template`, `Create Template (v2)`, `Delete Ingested Media`, plus 21 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Put Shotstack to work tonight.
Connect in two clicks, describe an outcome, and your first workflow is live in minutes. Free plan included — no card required.