Skip to main content
DELETE
/
video
/
{video_id}
/
storage
Delete video storage
curl --request DELETE \
  --url https://api.videodb.io/video/{video_id}/storage/ \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "message": "Operation successful"
}

Documentation Index

Fetch the complete documentation index at: https://docs.videodb.io/llms.txt

Use this file to discover all available pages before exploring further.

Delete only the video file from storage while keeping the video metadata, indexes, and transcripts. This reduces storage costs when you no longer need the original file.
import videodb

conn = videodb.connect(api_key="your_api_key")
coll = conn.get_collection()

# Get video
video = coll.get_videos()[0]

# Remove storage while keeping metadata
video.remove_storage()

print("Video storage deleted (metadata retained)")
  • This operation is irreversible and cannot restore the video file
  • After removal, you cannot generate new streams or thumbnails from the video
  • Existing generated streams and thumbnails remain available
  • Video metadata, indexes, and transcripts are preserved
  • Used for cost optimization when original file is no longer needed

Authorizations

x-access-token
string
header
required

API key for authentication (sk-xxx format)

Path Parameters

video_id
string
required
Pattern: ^m-
Example:

"m-12345"

Response

200 - application/json

Video storage deleted

success
boolean
Example:

true

message
string
Example:

"Operation successful"