> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chowder.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload File

> Upload a binary file to the instance via multipart form data.

Uploads a file to the instance using multipart form data. This is the way to go for binary files like images, audio, or anything that isn't plain text. For text content, you can also use the simpler [write endpoint](/api-reference/files/write).

## Authentication

Requires an **org-level API key** or a **scoped token** with the appropriate permission.

## Path Parameters

<ParamField path="instance_id" type="string" required>
  The ID of the instance.
</ParamField>

## Form Parameters

<ParamField body="path" type="string" required>
  The destination file path on the instance, relative to the instance root.
</ParamField>

<ParamField body="file" type="file" required>
  The file to upload (binary).
</ParamField>

## Response

Returns `204 No Content` on success.

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  curl -X POST https://api.chowder.dev/v1/instances/ins_abc123/files/upload \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -F "path=assets/logo.png" \
    -F "file=@/local/path/to/logo.png"
  ```
</RequestExample>

<ResponseExample>
  ```text 204 theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  No Content
  ```
</ResponseExample>