Account Information13

Alerts5

Applicant Tracking10

Benefits10

Calendar Events1

Change Tracking2

Company Files6

Company Profile3

Compensation3

Compensation Benchmarking11

Compensation Planning28

Custom Fields12

Custom Reports4

Custom Tables7

Datasets8

Employee Files6

Employee Tables6

Employee Verification5

Employees8

Field Metadata4

Goals24

Holidays8

Hours1

Locations5

Login1

Meal & Rest Breaks20

Onboarding12

Pay Grades & Bands14

Photos2

Public API5

Recognition Settings1

Reports2

Scheduling21

Time Off37

Time Tracking63

Total Rewards8

Training12

Webhooks8

Webhooks

Webhook Events6

Company Files

Public API

Update Company File

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

post/api/v1/files/{fileId}

Request

Base URL
https://companySubDomain.bamboohr.com
Auth
- HTTP basic
- or OAuth 2
  Authorization code/authorize.php
  Token URL/token.php
  Scopescompany_file.write
TypeScript
https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/files/:fileId/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

fileIdinteger required

The ID of the company file to update.

Request body

namestring

The new display name for the file.

categoryIdstring

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

shareWithEmployee'yes' | 'no'

Whether the file is shared with employees.

Response

The company file was updated successfully.

Changes

No recorded changes to this operation across all 2 revisions of this API.