Video

Endpoints related to video creation and management.

Remove a video by ID

delete

Deletes a video by its ID. This is used to remove videos that are no longer needed or were created in error.

Authorizations

apiKey

blotato-api-keystringRequired

Path parameters

idstringRequired

Video ID

Example: 123e4567-e89b-12d3-a456-426614174000

Responses

204

Success

application/json

500

Server error

application/json

delete

/v2/videos/{id}

HTTPcURLJavaScriptPython

DELETE /v2/videos/{id} HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Get a single video

get

Retrieves the video by its ID. This is useful for polling after creating a video programmatically.

Authorizations

apiKey

blotato-api-keystringRequired

Path parameters

idstringRequired

Video ID

Example: 123e4567-e89b-12d3-a456-426614174000

Responses

200

Default Response

application/json

404

Not found

application/json

500

Server error

application/json

get

/v2/videos/creations/{id}

HTTPcURLJavaScriptPython

GET /v2/videos/creations/{id} HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "completed",
    "createdAt": "2026-01-29T19:01:06.984Z",
    "mediaUrl": "https://database.blotato.io/media/12345.mp4"
  }
}

Create a video from the new template system

post

Creates a new video using a template. The template takes an ID and input parameters. You can also provide an optional prompt to fill out the input parameters automatically.

Authorizations

apiKey

blotato-api-keystringRequired

Body

application/json

templateIdstringRequired

inputsanyRequired

promptstringOptional

isDraftbooleanOptionalDefault: false

renderbooleanRequiredDefault: true

Responses

201

Default Response

application/json

404

Not found

application/json

500

Default Response

application/json

post

/v2/videos/from-templates

HTTPcURLJavaScriptPython

POST /v2/videos/from-templates HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "templateId": "text",
  "inputs": null,
  "prompt": "text",
  "isDraft": false,
  "render": true
}

{
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "queueing"
  }
}

List all templates

get

List all available video templates along with the specification of their input parameters.

Authorizations

apiKey

blotato-api-keystringRequired

Query parameters

fieldsstringOptional

Comma separated list of fields to include. If provided, only these fields will be included in the response for each template. If omitted, only id, title, and description are included. Id is always included in the response.

Default: id,title,descriptionExample: id,title,description,inputs

searchstringOptional

Search regex term to filter templates by title or description. Has no effect if "id" is also provided.

Example: real estate

idstringOptional

If provided, only the template with this ID will be returned.

Example: /base/v2/tweet-card/9714ae5c-7e6b-4878-be4a-4b1ba5d0cd66/v1

Responses

200

Default Response

application/json

500

Default Response

application/json

get

/v2/videos/templates

HTTPcURLJavaScriptPython

GET /v2/videos/templates HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": []
}