v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB
Employee Files
Public API

List Employee Files

Lists the file categories and files visible to the caller for the specified employee. This is a metadata listing (names, sizes, permissions); to download a file's content use get-employee-file. The response format is controlled by the Accept header: send application/json for JSON or omit/send anything else for XML. Only categories and files the caller is permitted to see are included; employees viewing their own profile also see files shared with them. Returns 404 when the employee has no accessible categories.

OAuth Scopes: employee:file

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

Path parameters

idstring required

The internal employee ID of the employee whose files are being listed.

Headers

Acceptstring

Set to application/json to receive a JSON response. Any other value (or omitted) returns XML.

Response

The employee's file categories and files. Each category contains permission flags and an array of file metadata.