---
title: "Delete a file"
method: DELETE
path: "/files/{file_id}"
tags: ["files"]
---

# Delete a file

`DELETE /files/{file_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. This runs the same for an uploaded or a captured file; a capture's source phone keeps its own session copy, which belongs to the session, not the library.

## Path parameters

- `file_id` string, uuid, required — file 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.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/8a66f81813b3/schema)