Skip to main content
Delete a video by ID. The video is removed from your library and can no longer be accessed. The response returns the metadata of the deleted video.
This action is permanent and cannot be undone. The video file and all associated data are deleted.

Endpoint

DELETE /v1/videos/:id

Authentication

Pass an all_access API key as a Bearer token in the Authorization header.
Authorization
string
required
Your API key. Format: Bearer <api_key>. Must have all_access permission.

Path parameters

id
number
required
The ID of the video to delete.

Response

data
object
required

Error responses

StatusDescription
400The provided id is not a valid number.
403The video exists but belongs to a different account.
404No video found with the given ID in your account.

Examples

curl --request DELETE \
  --url https://api.demomatic.tech/v1/videos/123 \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response

200
{
  "data": {
    "id": 123,
    "domain_id": 45,
    "filename": "Product Tour Q1 2024",
    "created_at": "2024-01-15T10:00:00.000Z",
    "updated_at": "2024-01-15T10:05:00.000Z"
  }
}