---
title: "Delete a file from a Vault project"
method: DELETE
path: "/api/v1/vault/delete_file/{file_id}"
tags: ["Vault"]
---

# Delete a file from a Vault project

`DELETE /api/v1/vault/delete_file/{file_id}`

Enables authorized organizations to remove an existing file from a Vault project. The endpoint verifies that the file exists and that the requesting user belongs to the file's workspace before proceeding with the deletion. In cases where deletion cannot be immediately completed (for example, if there are pending jobs associated with the file), the API responds with a conflict status. On success, the system logs an audit event and returns confirmation of the deletion.

## Path parameters

- `file_id` string, uuid, required

## Response `200`

File successfully deleted

- object
  - `success` boolean
  - `message` string

## Other responses

- `401` — Unauthorized - Invalid or missing API token
- `403` — Forbidden - User does not have required permissions
- `404` — File not found
- `409` — Conflict - File cannot be deleted due to pending jobs or other constraints
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/harvey/apis/harvey-client-matter-api.md) · [All operations](https://skmtc.dev/harvey/apis/harvey-client-matter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/harvey/harvey-client-matter-api/revisions/4a9e0925d49e/schema)
