Skip to main content
DELETE /v1/videos/{id}
Permanently deletes a video and all its associated assets (video file, thumbnail, spritesheet).
This action is irreversible. Once deleted, the video cannot be recovered.

​
Path Parameters

​
id
string
required
The unique identifier of the video to delete.

​
Response

​
success
boolean
Whether the deletion was successful.
​
message
string
A confirmation message.

​
Examples

​
Delete a Video

import requests

video_id = "vid_abc123"

response = requests.delete(
    f"https://api.voidai.app/v1/videos/{video_id}",
    headers={"Authorization": "Bearer sk-voidai-your_key_here"}
)

result = response.json()
print(result["message"])

​
Response Example

{
  "success": true,
  "message": "Video deleted successfully"
}

​
Error Responses

​
Video Not Found

{
  "error": {
    "message": "Video not found",
    "type": "api_error",
    "code": "NOT_FOUND"
  }
}

​
Unauthorized

{
  "error": {
    "message": "You do not have permission to delete this video",
    "type": "api_error",
    "code": "FORBIDDEN"
  }
}