Shotstack for AI agents
Agents read Shotstack at once. Changes and sends are held for a person's approval by default.
About Shotstack
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 an agent can do in Shotstack
Every Shotstack action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Shotstack without asking first. 12 actions.
- Get AssetTool 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 IDTool 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 Render StatusTool 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 Template By VersionTool to retrieve a template by template id and API version. Use when you need to fetch template details from a specific Edit API version.
- 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 with EnvironmentTool to list all Shotstack templates for the specified environment. Use when you need to retrieve templates from a specific environment (stage or production).
- Get Render CallbackTool 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-statu
- Get Source DetailsTool 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 fi
- Get TemplateTool to retrieve details of a specific template. Use when you have the ID of an existing template and need its metadata.
- Inspect MediaTool 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
- List SourcesTool to list all source assets. Use when you need to retrieve source entries with optional pagination.
- List TemplatesTool to list all Shotstack templates for the account. Use after creating or updating templates to view your available templates.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 11 actions.
- 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.
- Get Upload URLTool 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 Upload URLTool 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.
- Transfer AssetTool 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 configur
- Update TemplateTool 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.
- Create TemplateTool 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.
- Delete Ingested MediaTool to delete an ingested media asset. Use when you've confirmed the ingest ID and need to remove the file from Shotstack storage.
- Delete TemplateTool to delete a specific Shotstack template by its ID. Use when you need to remove a template permanently.
- Delete Shotstack WorkflowTool to delete a specific Shotstack workflow. Use when you need to permanently remove a workflow after confirming its ID.
- Fetch SourceTool 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
- Render VideoTool to initiate a new video render job. Use when you have defined a timeline and output settings and want to start rendering.
Changes wait in Needs you
Changes and sends in Shotstack are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Shotstack questions
Can an agent change data in Shotstack on its own?
Not by default. Changes and sends in Shotstack are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Shotstack?
This connector lists 12 read actions. Reads run at once, without waiting for approval.
How does Shotstack connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.