---
title: "Delete a download"
method: DELETE
path: "/downloads/{download_id}"
tags: ["downloads"]
---

# Delete a download

`DELETE /downloads/{download_id}`

Removes a captured file from the org's library: the stored object and the library entry, freeing its quota. If the file was pushed to phones, those copies are scheduled for removal like an upload's. The copy in the phone's own gallery is removed on the library-deletes-everywhere policy as the device-side support ships.

## Path parameters

- `download_id` string, uuid, required — download identifier to delete

## Response `200`

OK

- DeleteFileOutputBody — Confirmation that the file was deleted.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `message` string, required
  - `phones_pending_removal` integer, required — Phones that still hold a copy and have been scheduled to remove it. Zero means the file is already gone everywhere.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.net/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axilioai/axilio-api/revisions/108ab4b41051/schema)