---
title: "Bulk Delete Downloads"
method: POST
path: "/utilities/downloads/bulk-delete"
tags: ["Utilities"]
---

# Bulk Delete Downloads

`POST /utilities/downloads/bulk-delete`

Delete unique downloads after strict all-member preflight; missing, referenced, active, or unsafe members prevent all deletion, while unexpected cleanup failures return typed partial results

## Request body

- InternalHandlersUtilitiesBulkDeleteDownloadRequest
  - `ids` integer[], required

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseGithubComAlchemillahqSylveInternalInterfacesServicesUtilitiesDownloadDeleteResult
  - `data` GithubComAlchemillahqSylveInternalInterfacesServicesUtilitiesDownloadDeleteResult
    - `deleted` GithubComAlchemillahqSylveInternalInterfacesServicesUtilitiesDownloadDeleteItem[]
      - `id` integer
      - `name` string
      - `type` 'http' | 'torrent' | 'path'
      - `uuid` string
    - `failed` GithubComAlchemillahqSylveInternalInterfacesServicesUtilitiesDownloadDeleteFailure[]
      - `code` string
      - `id` integer
      - `name` string
      - `retainedPaths` string[]
      - `type` 'http' | 'torrent' | 'path'
      - `uuid` string
      - `vmReferences` GithubComAlchemillahqSylveInternalInterfacesServicesUtilitiesDownloadDeleteVMReference[]
        - `storageId` integer
        - `vmId` integer
        - `vmName` string
        - `vmRid` integer
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — One or more downloads not found; nothing deleted
- `409` — One or more downloads active, referenced, or unsafe; nothing deleted
- `413` — Request body too large
- `500` — Cleanup or persistence failure, possibly partial

---

[API](https://skmtc.net/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.net/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alchemillahq/sylve-api/revisions/7a7bea85004e/schema)
