---
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: the stored object, the library entry and its delivery history. Copies already delivered to a phone are left in place for now: on a shared phone they are destroyed when the phone is released, while on a dedicated phone they persist until the phone is cleaned up.

## 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

## Other responses

- `default` — Error

## Changes

- **2026-07-26** `a0204e0956bc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/axilioai/apis/axilio-api/changes/uploads/:upload_id/delete.md)

---

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