---
title: "Update a file's metadata"
method: PATCH
path: "/v1/org/{orgId}/file/{fileId}"
tags: ["file"]
---

# Update a file's metadata

`PATCH /v1/org/{orgId}/file/{fileId}`

## Path parameters

- `orgId` string, required
- `fileId` string, required

## Request body

- UpdateFileEntity
  - `fieldId` string — field that the file uses, if the file is tied to a field
  - `sensitive` 'GLOBAL' | 'ORG' | 'SENSITIVE' | 'PERSONAL' | 'MANAGER' | 'HIGH' | 'PRIVATE' — level of sensitivity of the file, if the file is not tied to a field
  - `filename` string — customer facing filename of file
  - `metadata` object — Optional metadata about the file

## Response `204`

file deleted

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/versions/50a1edd6b27e/schema)