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

Path parameters

idstringRequired

Video ID

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

Responses

204

Success

application/json

500

Server error

application/json

delete

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

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

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": "2025-08-02T22:27:17.941Z",
    "mediaUrl": "https://database.blotato.io/media/12345.mp4"
  }
}