---
title: "Write a file in a Box"
method: PUT
path: "/boxes/{boxId}/files"
tags: ["Box"]
---

# Write a file in a Box

`PUT /boxes/{boxId}/files`

## Path parameters

- `boxId` string, required

## Request body

- FileWriteRequest
  - `path` string, required — Relative path inside the Box work directory.
  - `content` string, required
  - `encoding` 'utf8' | 'base64'

## Response `200`

File written.

- FileWriteResponse
  - `ok` boolean, required
  - `type` 'file.written', required — Stable success envelope discriminator added by v1.
  - `success` boolean, required
  - `path` string, required
  - `encoding` 'utf8' | 'base64', required
  - `size` integer, required

---

[API](https://skmtc.dev/ascii/apis/box-public-api-v1.md) · [All operations](https://skmtc.dev/ascii/apis/box-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ascii/box-public-api-v1/revisions/82d576f82046/schema)