---
title: "Files - delete a file"
method: DELETE
path: "/api/v1/files/{fileId}"
tags: ["Files"]
---

# Files - delete a file

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

Permanently removes a file and its stored blob.

## Path parameters

- `fileId` string, uuid, required

## Response `200`

File deleted

- DeleteFileResponse — Success response for file deletion
  - `ok` true, required
  - `data` DeleteResult, required — Confirmation that a resource was successfully deleted
    - `deleted` true, required

## Other responses

- `404` — Not found

## Changes

- **2026-04-30** `bef883f8a334` — 9 info
  - api operation id `deleteFile` removed and replaced with ``
  - the response property `data` became required for the status `200`
  - the response property `data/deleted` became required for the status `200`
  - the response property `ok` became required for the status `200`
  - …5 more
- **2026-04-17** `5eb4ed0f33c7` — 6 breaking, 2 warning, 1 info
  - the response property `data` became optional for the status `200`
  - the response property `data/deleted` became optional for the status `200`
  - the response property `ok` became optional for the status `200`
  - the `deleted` response property const value `true` was removed for the status `200`
  - …5 more

[Change history](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/changes/api/v1/files/:fileId/delete.md)

---

[API](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api.md) · [All operations](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitbybit-dev/bitbybit-cad-cloud-api/revisions/1135d4473bc2/schema)