---
title: "Delete an upload"
method: DELETE
path: "/uploads/{upload_id}"
tags: ["uploads"]
---

# Delete an upload

`DELETE /uploads/{upload_id}`

Removes a file from the org's library and everywhere it was delivered: the stored object and the library entry go immediately, and every phone holding a copy is scheduled to remove it (removal is confirmed per phone and retried until it lands). The response reports how many phones that recall reaches.

## Path parameters

- `upload_id` string, uuid, required — upload 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)