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

blotato-api-keystringRequired

Path parameters

idstring · uuidRequired

Video ID

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

Responses

204

Success

application/json

Success

idstring · uuidRequired

Video ID

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

403

Forbidden

application/json

500

Server error

application/json

delete/v2/videos/{id}

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. When error is set, generation has stopped and the status will not change again, even if it is not a final status.

Authorizations

blotato-api-keystringRequired

Path parameters

idstring · uuidRequired

Video ID

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

Responses

200

Default Response

application/json

403

Forbidden

application/json

404

Not found

application/json

500

Server error

application/json

get/v2/videos/creations/{id}

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-10-12T20:55:09.939Z",
    "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

blotato-api-keystringRequired

Body

templateIdstringRequired

inputsanyRequired

promptstringOptional

isDraftbooleanOptionalDefault: false

renderbooleanRequiredDefault: true

titlestring · min: 1Optional

useBrandKitbooleanOptionalDefault: false

brandIdstring · nullableOptional

Responses

201

Default Response

application/json

403

Forbidden

application/json

404

Not found

application/json

500

Default Response

application/json

post/v2/videos/from-templates

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: 133

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

{
  "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

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

403

Forbidden

application/json

500

Default Response

application/json

get/v2/videos/templates

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

{
  "items": []
}