v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB
Files

Preflight check before upload

Performs a check to verify that a file will be accepted by Box before you upload the entire file.

options/files/content

Request body

namestring

The name for the file.

sizeinteger

The size of the file in bytes.

Example request

{
  "name": "File.mp4",
  "size": 1024,
  "parent": {
    "id": "123"
  }
}

Response

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

upload_urlstring

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

upload_tokenstring

An optional access token to use to upload the file.

Example response

{
  "upload_url": "https://upload-las.app.box.com/api/2.0/files/content?upload_session_id=1234",
  "upload_token": "Pc3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQP"
}