---
title: "Delete File"
method: DELETE
path: "/api/v1/files/{file_id}"
tags: ["files"]
---

# Delete File

`DELETE /api/v1/files/{file_id}`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/files/{file_id}`
- Auth: none declared

Soft-delete the file and immediately release the quota.

The R2 binary lingers for 7 days (sweeper handles deletion); the
workspace counter is decremented in the same transaction (R5).

## Path parameters

- `file_id` string, uuid, required

## Query parameters

- `workspace_id` string, uuid, required: Owning workspace

## Headers

- `authorization` string, nullable

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/aa9df1a21db9?raw)