Delete Video

DELETE /v1/videos/:id

Permanently delete a video and its stored files - the source video, thumbnail, and any exported video, SRT or voiceover.

This cannot be undone

There is no trash and no restore. The stored files are removed as well as the record.

Path parameters

Parameter	Type	Description
id	string	The video ID

Example

curl -X DELETE https://api.vidocu.ai/v1/videos/vid_abc123 \
  -H "Authorization: Bearer vdo_live_your_key_here"

Response 200 OK

{
  "success": true,
  "id": "vid_abc123",
  "deleted": true
}

Locked videos

Locked videos are permanent records and can't be deleted. Unlock the video in the Vidocu app first.

The same protection applies to deleting a project with ?cascade=true: if the project holds any locked video, the whole delete is refused rather than partly applied.

Errors

Status	Code	Cause
401	authentication_error	Invalid or missing API key
403	insufficient_role	The workspace role behind the token can't delete content
404	not_found	Video doesn't exist or belongs to another workspace
423	locked	The video is locked - unlock it in the Vidocu app first