---
title: "Delete a terminal clip batch"
method: DELETE
path: "/clip-batches/{batch_id}"
tags: ["Clip Creation"]
---

# Delete a terminal clip batch

`DELETE /clip-batches/{batch_id}`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/clip-batches/{batch_id}`
- Auth: API key in header `Authorization`

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.

## Path parameters

- `batch_id` string, required

## Query parameters

- `retention` 'retain_projects_and_exports' | 'delete_projects_and_exports'
- `dry_run` boolean
- `confirm_delete` boolean

## Response `200`

Successful response

- object
  - `batch_id` string, required
  - `status` string, required
  - `retention` 'retain_projects_and_exports' | 'delete_projects_and_exports', required
  - `dry_run` boolean, required
  - `clip_ids` string[], required
  - `project_ids` string[], required
  - `export_ids` string[], required
  - `shared_project_ids` string[], required
  - `deleted_batch_count` integer, required
  - `deleted_clip_count` integer, required
  - `deleted_project_count` integer, required
  - `deleted_export_count` integer, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)