Skip to main content
OPTIONS
/
files
/
content
cURL
curl -i -X OPTIONS "https://api.box.com/2.0/files/content" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{"name":"Contract.pdf", "parent":{"id":"11446498"}}'
{
  "upload_url": "https://upload-las.app.box.com/api/2.0/files/content?upload_session_id=1234",
  "upload_token": "Pc3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQP"
}

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.

This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.Learn more about Box SDK versioning strategy.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
name
string

The name for the file.

Example:

"File.mp4"

​
size
integer<int32>

The size of the file in bytes.

Example:

1024

​
parent
object

The parent folder to upload the file to.

Response

If the check passed, the response will include a session URL that can be used to upload the file to.

The details for the upload session for the file.

​
upload_url
string

A URL for an upload session that can be used to upload the file.

Example:

"https://upload-las.app.box.com/api/2.0/files/content?upload_session_id=1234"

​
upload_token
string

An optional access token to use to upload the file.

Example:

"Pc3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQP"