Skip to main content
POST
Prepare a Large Upload
Direct uploads to POST /parse take up to 50 MB. For files up to 500 MB:
  1. POST /api/parse/uploads with { "fileName": "annual-report.pdf", "size": 182345678 }. The response has a fileId and an uploadUrl.
  2. PUT the file’s bytes to uploadUrl within 15 minutes. No API key is needed for this request.
  3. Parse it with POST /api/parse and { "fileId": "..." }, plus any options.
Parsing a fileId before the file has been uploaded returns 409.

Reusing and deleting files

Every uploaded or linked document gets a fileId, valid for 24 hours, so you can parse it again with other pages or another prompt without sending it again. After 24 hours it is deleted.

Delete an uploaded file

DELETE /api/parse/files/{fileId} deletes it now.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
fileName
string
required
size
integer
required

Bytes

Response

Prepared

fileId
string
uploadUrl
string
method
enum<string>
Available options:
PUT
expiresIn
integer