Preflight check before upload

options

https://api.box.com/2.0

/files/content

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

Related Guides

Request

Content-Typeapplication/json

Request Body

name stringin bodyoptional

exampleFile.mp4

The name for the file

parent objectin body

The parent folder to upload the file to

parent.id stringnulloptional

example123

The ID of parent item

size integer / int32in bodyoptional

example1024

The size of the file in bytes

Response

200application/jsonUpload URL

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

409application/jsonConflict error

If the check did not pass, the response will include some details on why it did not pass.

defaultapplication/jsonClient error

An unexpected client error.

options

Preflight check before upload

You can now try out some of our APIs live, right here in the documentation.

Request Example

cURL

curl -X OPTIONS https://api.box.com/2.0/files/content \
     -H 'Authorization: Bearer <ACCESS_TOKEN>'
     -H "Content-Type: multipart/form-data" \
     -F attributes='{"name":"Photo.jpg", "parent":{"id":"11446498"}}'

Java

String fileName = "My Doc.pdf";
BoxFolder rootFolder = BoxFolder.getRootFolder(api);
try {
    folder.canUpload(fileName, 98734576);

    // If the file upload would not have succeeded, it will not be attempted
    folder.uploadFile(fileContents, fileName);
} catch (BoxAPIException ex) (

)

Node

// Verify that uploading a 200MB file named "Preso.ppt" to folder 12345 would succeed
client.files.preflightUploadFile(
		'12345',
		{
			name: 'Preso.ppt',
			size: 200000000
		},
		null,
		callback
	);