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

# Uploads

> Upload files to Box using direct upload for files up to 50 MB or chunked upload for larger files with retry control.

The Box API supports two distinct methods of file upload. The direct file
upload API supports files up to 50 MB and sends all the binary
data to the Box API in one request.

The chunked upload APIs support files from 20 MB.
Upload the file in parts so you can catch errors and retry each part.
When you upload a new version of a large
file, you can also
skip the parts Box already stores
from the previous version.

> [!TIP]
>
> To upload files to the Archive folder, first enable the Global
> Content Manager (GCM) scope in the Developer Console.

## Quick example

Upload a file to the root folder:

```bash theme={null}
curl -X POST https://upload.box.com/api/2.0/files/content \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -F attributes='{"name": "example.pdf", "parent": {"id": "0"}}' \
  -F file=@example.pdf
```

## Upload limits

Upload limits depend on the authenticated user's account type.
See the maximum file size you can upload.

## Preflight check

The preflight check API enables you to verify that Box accepts a file
before you upload any bytes. You can use it for new files and for new versions
of existing files.

> [card] Learn more about preflight checks

## Upload domain

Uploads to Box use a different domain (`upload.box.com`) than regular API
calls. Keep this in mind when you write your own upload code. The
Box SDKs choose the right domain for each API call.

[fsizes]: https://support.box.com/hc/en-us/articles/360043697314-Understand-the-Maximum-File-Size-You-Can-Upload-to-Box
