Box Developer Documentation
Log in
 

Create upload session

post
https://upload.box.com/api/2.0
/files/upload_sessions

Creates an upload session for a new file.

Related Guides

Request

application/json

Request Body

stringin bodyrequired
Project.mov

The name of new file

integer / int64in bodyrequired
104857600

The total number of bytes of the file to be uploaded

stringin bodyrequired
0

The ID of the folder to upload the new file to.

Response

application/jsonUpload session

Returns a new upload session.

application/jsonClient error

Returns an error if some of the parameters are missing or not valid.

  • missing_destination: No folder_id was provided
  • invalid_folder_id: folder_id is not valid
  • invalid_file_name: file_name is not valid
  • missing_file_size: file_size was not provided
  • invalid_file_size: file_size was not a valid number
  • file_size_too_small: file_size is below minimum file size for uploads via this API
  • missing_file_name: file_name was not provided
application/jsonClient error

Returns an error if the file already exists, or the account has run out of disk space.

application/jsonClient error

An unexpected client error.

post
Create upload session
You can now try out some of our APIs live, right here in the documentation.
Log in

Request Example

cURLJavaPythonNode
cURL
curl -X POST https://upload.box.com/api/2.0/files/upload_sessions \
     -H 'Authorization: Bearer <ACCESS_TOKEN>'
     -H 'Content-Type: application/json" '
     -d '{
       "folder_id": "0",
       "file_size": 104857600,
       "file_name": "Project.mov"
     }'
Java
Python
Node