Skip to main content

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.)
Cannot be recovered after deletion!
Video deletion is permanent and cannot be undone. Make sure you have a backup if needed before deleting.

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)
For most users, storage costs are negligible compared to generation costs.

Error Responses

404 Not Found

Possible causes:
  • Video ID doesn’t exist
  • Video already deleted
  • Video belongs to different organization

403 Forbidden

Cause: Video belongs to a different organization. Solution: Only delete videos owned by your organization.

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
See the Authentication Guide for more details.

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