Skip to navigation

Upload File

Uploads a file from local disk so it can be parsed. Returns a captain:// id to pass as input to Parse Document or Parse Spreadsheet. Files that already sit behind a direct download link do not need this step.

Uploads are limited to 100 MB, can be parsed any number of times, and are deleted after 24 hours. Uploading is not billed.

Headers

authorizationstringOptional

Request

This endpoint expects a multipart form containing a file.
filefileRequired
The file to upload, up to 100 MB.

Response

The upload.
file_idstring

Pass this as input to Parse Document or Parse Spreadsheet.

expires_atstringformat: "date-time"
The upload is deleted 24 hours after it was created. After that the id no longer works.

Errors

400
Bad Request Error
401
Unauthorized Error
413
Content Too Large Error
503
Service Unavailable Error