Team
Shared credential for production and unattended runs.
Connect Shotstack with Hookshot™ and your stack
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.
Tools and triggers
What Agents can do in Shotstack
Available tools and events after Shotstack is connected.
-
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 Shotstack Workflow
Tool to delete a specific Shotstack workflow. Use when you need to permanently remove a workflow after confirming its ID.
-
Delete Template
Tool to delete a specific Shotstack template by its ID. Use when you need to remove a template permanently.
-
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…
-
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 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…
-
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…
-
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…
-
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…
-
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).
-
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.
-
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.
-
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.
Setup
Connect Shotstack in Hookshot™
Pick a scope, then confirm what can start a Protege and what it can do.
Trigger Access
What can start a Protege from this app.
Tool Access
What a Protege can do after it starts.
Connection scope
Prefer team for production.
Personal
Tied to one user—only when the workflow needs their account.
Chat
Team-scoped for supported chat surfaces.
Build with us
See Hookshot™ in your stack.
Request early access or book a live walkthrough with the team.
