API Reference
Deletes the batch and its clip records. Projects and exports are retained by default; pass delete_projects_and_exports for explicit cascading soft deletion. Active batches and shared projects are protected.
Authorization
ApiKeyAuth Authorization<token>
Use Bearer br_live_....
In: header
Path Parameters
batch_id*string
Query Parameters
retention?string
Default
"retain_projects_and_exports"Value in
- "retain_projects_and_exports"
- "delete_projects_and_exports"
dry_run?boolean
confirm_delete?boolean
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/clip-batches/string"{ "batch_id": "string", "status": "string", "retention": "retain_projects_and_exports", "dry_run": true, "clip_ids": [ "string" ], "project_ids": [ "string" ], "export_ids": [ "string" ], "shared_project_ids": [ "string" ], "deleted_batch_count": -9007199254740991, "deleted_clip_count": -9007199254740991, "deleted_project_count": -9007199254740991, "deleted_export_count": -9007199254740991}