Delete Video
Permanently delete a video and free up storage.Request
Path Parameters
Headers
Response
Success (200 OK)
Examples
Batch Delete
Delete multiple videos:Delete Failed Videos
Delete Old Videos
What Gets Deleted
When you delete a video, the following are permanently removed:- ✅ Video file from R2 storage
- ✅ Video metadata from database
- ✅ All associated data (enhanced prompts, cost info, etc.)
Deletion and Billing
Credits Not Refunded
Deleting a video does not refund the credits used to generate it:Storage Savings
Deleting videos frees up storage space:- R2 storage: Videos in R2 count toward storage quota
- Metadata: Reduces database usage
- Cost: Saves on R2 storage fees ($0.015/GB-month)
Error Responses
404 Not Found
- Video ID doesn’t exist
- Video already deleted
- Video belongs to different organization
403 Forbidden
Deletion Safety
Confirmation Prompt
Always confirm before deletion in UI:Soft Delete (Archive)
Instead of deleting, archive videos by storing IDs:Required Scopes
This endpoint requires the following API key scopes:video:delete- Delete videos
Next Steps
List Videos
View all your videos before deleting
Retrieve Video
Check video details before deletion
Create Video
Generate a new video
Download Video
Download before deleting