---
title: "Delete Employee File"
method: DELETE
path: "/api/v1/employees/{id}/files/{fileId}"
tags: ["Employee Files", "Public API"]
---

# Delete Employee File

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

Permanently deletes an employee file. This action cannot be undone and removes the file from storage. The special employee ID of 0 resolves to the employee associated with the authenticated caller. Returns 200 even if the file was already deleted (idempotent). Returns 403 if the caller lacks permission or the file belongs to a BambooPayroll-managed section. Returns 404 if the file does not exist for the specified employee or the Files tool is not enabled for the company. Use 'List Employee Files' to obtain file IDs.

OAuth Scopes: employee:file.write

## Path parameters

- `id` integer, required
- `fileId` integer, required

## Response `200`

The employee file was deleted successfully, or had already been deleted for this employee.

## Other responses

- `403` — The caller does not have permission to delete this employee's file, or the file belongs to a BambooPayroll-managed section and the caller is not a payroll admin.
- `404` — The file was not found for the specified employee, or the Files tool is not enabled for this company.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)