post
https://{companyDomain}.bamboohr.com/api/v1/files/
Updates metadata for an existing company file. Supports renaming the file, moving it to a different category, and toggling employee visibility. Accepts JSON or XML. Only fields included in the request body are updated.
OAuth Scopes: company_file.write
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Sample Request
{
"name": "This is a new name for the file",
"categoryId": "4",
"shareWithEmployees": "no"
}Files That Can Be Updated
name - rename the file.
categoryId - move the file to a different category.
shareWithEmployees - update whether this file is shared or not.
The company file was updated successfully.
The request body contains malformed JSON or XML.
The API user does not have permission to modify this file or its category.
The file or the target category was not found.