> ## Documentation Index
> Fetch the complete documentation index at: https://developers.harvey.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a file from a Vault project

> 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.

### Permissions

Requires `Vault API` and `Modify workspace projects` permissions.


## OpenAPI

````yaml /vault_api.json delete /api/v1/vault/delete_file/{file_id}
openapi: 3.0.1
info:
  title: Vault - Upload Documents
  description: >-
    The Vault Upload Documents API enables users to programmatically upload and
    manage documents within Vault projects. This API allows organizations to
    maintain projects with their own internal files for their users to use
    within the Harvey app.
  version: 1.0.0
  contact:
    email: support@harvey.ai
servers:
  - url: https://api.harvey.ai
    description: Harvey API server
security: []
paths:
  /api/v1/vault/delete_file/{file_id}:
    delete:
      tags:
        - Vault
      summary: Delete a file from a Vault project
      description: >-
        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.
      operationId: deleteVaultFile
      parameters:
        - name: file_id
          in: path
          required: true
          description: The unique identifier of the file to delete
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: File successfully deleted
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: File successfully deleted
        '401':
          description: Unauthorized - Invalid or missing API token
        '403':
          description: Forbidden - User does not have required permissions
        '404':
          description: File not found
        '409':
          description: >-
            Conflict - File cannot be deleted due to pending jobs or other
            constraints
        '429':
          description: Too Many Requests - Rate limit exceeded
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````