---
title: "Update Company File"
method: POST
path: "/api/v1/files/{fileId}"
tags: ["Company Files", "Public API"]
---

# Update Company File

`POST /api/v1/files/{fileId}`

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

## Path parameters

- `fileId` integer, required

## Request body

- CompanyFileUpdate
  - `name` string — The new display name for the file.
  - `categoryId` string — The ID of the category (file section) to move the file to.
  - `shareWithEmployee` 'yes' | 'no' — Whether the file is shared with employees.

## Response `200`

The company file was updated successfully.

## Other responses

- `400` — The request body contains malformed JSON or XML.
- `403` — The API user does not have permission to modify this file or its category.
- `404` — The file or the target category was not found.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)