Skip to content
Changelog

Report a bug

Shotstack integration: operations for AI agents

Shotstack connects to Type.com as an integration. This page lists the 23 operations documented for Claude and Codex in Type.com: 12 read, 7 write, 4 destructive.

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.

Categories: Design & Media

How to connect Shotstack to Type.com

Access
Organization connection: one shared account for the workspace.
MCP
Selected AI media-generation operations are not available through Type’s MCP server. Other operations remain available through MCP, subject to your connection’s permissions. These MCP restrictions do not apply within Type.

To add the connection, follow the steps in Space connections.

Documented operations

23 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

23 operations listed.

Edit

  • Read

    Get Render Status

    Get the rendering status, temporary asset url and details of a render by ID. Base URL: https://api.shotstack.io/edit/{version}

    GET /render/{id}

  • Read

    List Templates

    Retrieve a list of templates stored against a users account and stage. Base URL: https://api.shotstack.io/edit/{version}

    GET /templates

  • Read

    Retrieve Template

    Retrieve a template by template id. Base URL: https://api.shotstack.io/edit/{version}

    GET /templates/{id}

  • Read

    Inspect Media

    Inspects any media asset (image, video, audio) on the internet using a hosted version of FFprobe. The probe endpoint returns useful information about an asset such as width, height, duration, rotation, framerate, etc... Base URL: https://api.shotstack.io/edit/{version}

    GET /probe/{url}

  • Read

    Get Generation Status

    Get the status of an on-demand asset generation job created with the generate endpoint. Jobs are owner-scoped. Base URL: https://api.shotstack.io/edit/{version}

    GET /generate/{id}

  • Read

    List Generation Models

    List the generation models available for prompt-bearing image, video and audio assets generated from a prompt or, for some models, a source file, with the options each accepts. Use POST /generate/quote for a credit estimate.

    GET /models

  • Read

    Get Generation Model

    Get one generation model, including the JSON Schema for the options it accepts. Use POST /generate/quote for a credit estimate. Base URL: https://api.shotstack.io/edit/{version}

    GET /models/{id}

  • Write

    Render Asset

    Queue and render the contents of an Edit as a video, image or audio file. Rendering Process: 1. Validation: The edit JSON is validated 2. Download: All assets are downloaded and cached 3. Preprocessing: Video assets are automatically processed to fix compatibility issues 4.

    POST /render

  • Write

    Create Template

    Save an Edit as a re-usable template. Templates can be retrieved and modified in your application before being rendered. Merge fields can be also used to merge data in to a template and render it in a single request. Base URL: https://api.shotstack.io/edit/{version}

    POST /templates

  • Write

    Render Template

    Render an asset from a template id and optional merge fields. Merge fields can be used to replace placeholder variables within the Edit. Base URL: https://api.shotstack.io/edit/{version}

    POST /templates/render

  • Write

    Generate Asset

    Generate a single image, video or audio asset from a prompt or, for some models, a source file, without rendering a full edit.

    POST /generate

  • Write

    Quote Generation

    Estimate credits for the same asset and clip length accepted by POST /generate. Requires an API key and the same model access as generation. Invalid options and disallowed source URLs are rejected. No provider request, job, quota usage or credit reservation is created.

    POST /generate/quote

  • Destructive

    Update Template

    Update an existing template by template id. Base URL: https://api.shotstack.io/edit/{version}

    PUT /templates/{id}

  • Destructive

    Delete Template

    Delete a template by its template id. Base URL: https://api.shotstack.io/edit/{version}

    DELETE /templates/{id}

Serve

  • Read

    Get Asset

    The Serve API is used to interact with, and delete hosted assets including videos, images, audio files, thumbnails and poster images. Use this endpoint to fetch an asset by asset id. Note that an asset id is unique for each asset and different from the render id.

    GET /assets/{id}

  • Read

    Get Asset by Render ID

    A render may generate more than one file, such as a video, thumbnail and poster image. When the assets are created the only known id is the render id returned by the original render request, status request or webhook.

    GET /assets/render/{id}

  • Write

    Transfer Asset

    Transfer a file from any publicly available URL to one or more Serve API destinations. Base URL: https://api.shotstack.io/serve/{version}

    POST /assets

  • Destructive

    Delete Asset

    Delete an asset by its asset id. If a render creates multiple assets, such as thumbnail and poster images, each asset must be deleted individually by the asset id. Base URL: https://api.shotstack.io/serve/{version}

    DELETE /assets/{id}

Ingest

  • Read

    List Sources

    Retrieve a list of ingested source files stored against a users account and stage. Base URL: https://api.shotstack.io/ingest/{version}

    GET /sources

  • Read

    Fetch Source

    Queue a source file to be fetched from a URL and stored by Shotstack. Source files can be videos, images, audio files and fonts. Once ingested, new output renditions can be created from the source file. Base URL: https://api.shotstack.io/ingest/{version}

    POST /sources

  • Read

    Get Source

    Fetch a source file details and status by its id. Base URL: https://api.shotstack.io/ingest/{version}

    GET /sources/{id}

  • Write

    Direct Upload

    Request a signed URL to upload a file to. The response returns a signed URL that you use to upload the file to.

    POST /upload

  • Destructive

    Delete Source

    Delete an ingested source file by its id. Base URL: https://api.shotstack.io/ingest/{version}

    DELETE /sources/{id}

See How connections work for access and permissions, or browse all integrations.