v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB
Employee Files
Public API

Delete Employee File

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

delete/api/v1/employees/{id}/files/{fileId}

Path parameters

idinteger required

The internal employee ID of the employee whose file is being deleted. Use 0 to default to the employee associated with the authenticated caller.

fileIdinteger required

The ID of the employee file to delete.

Response

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