v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB
Employee Files
Public API

Get Employee File

Downloads the binary content of an employee file as an attachment. The response Content-Type header reflects the file's stored MIME type (e.g. application/pdf) and includes a Content-Disposition header with the original filename. The special employee ID of 0 resolves to the employee associated with the authenticated caller.

Use "List Employee Files" to discover file IDs and their categories for a given employee. Archived or soft-deleted files are excluded and return 404.

OAuth Scopes: employee:file

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

Path parameters

idinteger required

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

fileIdinteger required

The ID of the employee file to download.

Response

The employee file content streamed as a binary download. The Content-Type matches the file's stored MIME type and a Content-Disposition header provides the original filename.