---
title: "Delete User File"
method: DELETE
path: "/api/files/{file_id}"
---

# Delete User File

`DELETE /api/files/{file_id}`

Soft delete — flips deleted_at and decrements ref_count.
A future janitor task will GC blobs whose ref_count drops to 0
and prune the soft-deleted rows after some grace period.

## Path parameters

- `file_id` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/omicos/apis/omicos-server.md) · [All operations](https://skmtc.dev/omicos/apis/omicos-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omicos/omicos-server/revisions/a00b94573ffe/schema)