---
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 and everywhere it was delivered: the stored object and the library entry go immediately, and every phone the file was pushed to is scheduled to remove its copy (removal is confirmed per phone and retried until it lands), the same recall an upload's delete runs. The response reports how many phones that recall reaches. The source phone's own copy from the capture session is outside the recall: it belongs to the session, not the library.

## 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/4a74befa0bde/schema)