Skip to main content

Delete Project Endpoint

DELETE 
/v2/projects/{project_type}/{project_id}

Delete a project and all its linked videos asynchronously.

Returns 202 immediately with an empty body; the cascade runs in a background task. Clients poll GET on the project to detect completion: a 404 means the project document is gone (the user-visible signal that "the project is deleted"). Underlying per-video blob/storage cleanup may continue asynchronously for a short while after that point — perform_video_deletion schedules its own sub-tasks for files / folders / frames cleanup, which run after the cascade returns. None of that is user-visible.

Per-video failures abort the cascade and leave the project doc in place so the user's polling eventually times out and they retry.

A workspace's project is deleted by its creator and by the workspace's owners and admins. It is refused with 403, and nothing is deleted, when the project holds an item that the caller may not delete: ask an owner or admin of the workspace. An item the project does not own is unlinked, never deleted.

Note: this is a hard, fully-cascading delete. There is no "preserve videos" mode — for product_testing, a video stripped of its project context (task, analysis) is meaningless to the user. If a future project type ever needs "delete project but keep videos" semantics, add it then with concrete requirements.

Request​

Responses​

Successful Response