---
title: "Write a file"
method: PUT
path: "/v1/sessions/{id}/files"
---

# Write a file

`PUT /v1/sessions/{id}/files`

## Request

- Base URL: `https://assemble-vms-api.fly.dev`
- URL: `https://assemble-vms-api.fly.dev/v1/sessions/{id}/files`
- Auth: HTTP bearer

Write raw bytes, creating missing parent directories inside the running session. The maximum request body is 10 MiB. A running managed command or provided-agent request blocks file writes.

## Request body `application/octet-stream`

- string, binary

## Response `204`

File written.

## Other responses

- `default`: Structured API error. HTTP 400 invalid request, 401 authentication, 404 missing resource, 409 conflict, 413 size limit, 429 quota, or 503 unavailable.

---

[API](https://skmtc.dev/assemble/apis/assemble-vms-api.md) - [All operations](https://skmtc.dev/assemble/apis/assemble-vms-api/llms.txt) - [OpenAPI document](https://skmtc.dev/assemble/apis/assemble-vms-api/revisions/93f55a2e3de3?raw)