Delete a Project

DELETE /v1/projects/:id

Delete a project folder.

Behavior

By default, the videos inside the folder are kept — their projectId is cleared so they become uncategorized. Pass ?cascade=true to delete the videos and their S3 assets along with the folder.

Query parameters

Parameter	Type	Required	Default	Description
cascade	boolean	No	false	When true, deletes all videos in the folder and their S3 assets. Destructive — cannot be undone.

Example: keep videos (default)

curl -X DELETE https://api.vidocu.ai/v1/projects/0f7c1d8a-2c4b-4a9c-9f2a-1b8a3a5e0c11 \
  -H "Authorization: Bearer vdo_live_your_key_here"

Response 200 OK

{
  "success": true,
  "cascade": false,
  "deletedVideos": 0,
  "uncategorizedVideos": 4
}

Example: cascade delete

curl -X DELETE "https://api.vidocu.ai/v1/projects/0f7c1d8a-2c4b-4a9c-9f2a-1b8a3a5e0c11?cascade=true" \
  -H "Authorization: Bearer vdo_live_your_key_here"

Response 200 OK

{
  "success": true,
  "cascade": true,
  "deletedVideos": 4,
  "uncategorizedVideos": 0
}

Required scope

OAuth tokens need the projects:write scope.

Errors

Status	Code	Cause
401	authentication_error	Invalid or missing API key
403	insufficient_scope	OAuth token missing projects:write
404	not_found	Project does not exist or belongs to a different workspace