Update Employee File

Updates metadata for an existing employee file. Supports renaming the file, moving it to a different category, and toggling employee visibility. Accepts JSON or XML; only fields present in the request body are updated. An empty XML document no-ops successfully, while an empty JSON body returns 400. The categoryId field is silently ignored when the caller authenticated as the file creator but lacks full file permissions. Moving a file to a new category requires view/edit access to both the current and target category. Returns 403 if the file belongs to a read-only file section. Use 'List Employee Files' to obtain file IDs and category IDs.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the employee whose file is being updated.

integer
required

The ID of the employee file to update.

Body Params
string

The new display name for the file.

integer

The ID of the file category (section) to move the file into.

string
enum

Whether the file is shared with the employee. Also accepted as 'shareWithEmployees'.

Allowed:
string
enum

Alias for shareWithEmployee. Whether the file is shared with the employee.

Allowed:
Responses
200

The employee file metadata was updated successfully. No response body is returned.

400

The request body contains malformed JSON or XML.

403

The API user does not have permission to modify the requested employee's file, its category, or the file belongs to a read-only section.

404

The requested employee file or target category was not found.

500

An internal server error occurred.

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!