Upload Large Files for Parsing
Upload a large document to Unsiloed-managed storage with a presigned URL, then poll the standard Parse status endpoint.
Overview
The v2 presigned upload endpoint decouples document delivery from job creation. Instead of uploading your file through the API server, you:- POST to
/v2/parse/uploadwith your configuration: the API creates a parse job and returns a short-lived presigned URL. - PUT your file directly to the presigned URL: the API server is never in the transfer path.
- Once the upload completes, the job is automatically enqueued for processing.
- Poll
GET /parse/{job_id}to track progress and retrieve results (the same endpoint as the standard Parse flow).
AwaitingUpload. It transitions to Queued once the upload completes, then to Processing, and finally Succeeded or Failed. See Get Parse Job Status for the full response schema and polling examples.Request
"report.pdf"). Determines the MIME type for the presigned URL and selects the Excel pipeline for XLS and XLSX names. Supported formats: PDF, images (PNG, JPG/JPEG, TIFF/TIF, WebP), office documents (DOC, DOCX, PPT, PPTX, XLS, XLSX), and HTML (HTML/HTM).fast (Fast), agentic_lite (Agentic Lite), or agentic (Agentic). Each mode applies a recommended processing configuration that trades speed for fidelity. Parameters you send explicitly take precedence over the mode. See Processing Modes. Omit to use the default configuration.false.false.false.false."basic"(default): no chart data. Picture segments keep their usual description."standard": fast and accurate chart data extraction."advanced": for the most complex and messiest charts. Contact support to have this feature enabled for your organization; until it is, a request withadvancedreturns403witherror.codeset tofeature_not_enabled.
chart_data includes chart_type, chart_title, x_label, y_label, legend, confidence, metadata, and data: an object keyed by series name, each series a list of {"x": ..., "y": ...} points. It is attached only when the chart’s values were recovered; when it is, the segment’s markdown and html show the chart’s data as a summary and one table per series. Otherwise the segment keeps its description and has no chart_data.The Agentic (agentic) processing mode uses standard unless you set this field.false."1-5" (pages 1 to 5), "2,4,6" (specific pages), "[1,3,5]" (array format), "1-3,7,10-15" (combination).["docx", "markdown", "json"]. The exported files are available via the exports field in the task response."all" to include every type. Defaults to "all".["Table", "Formula", "Picture"]. Defaults to ["Table", "Picture"]; an empty or unparseable value also falls back to that default, so Table and Picture validation runs even when this field is omitted.segment_processing. The standard endpoint field segment_analysis is not accepted here and is silently ignored.html/markdown:"VLM"(use a VLM to generate the output) or"Auto"(skip the VLM call and build from the OCR/recognized text)vlm: Custom prompt for the VLM model. Use this to give the model specific instructions for extracting or describing these segment types.
KeyValuePair is configurable here too (form-field regions, produced for form documents). It returns an image crop URL alongside the text.For full details, see Parse Document.false to exclude them and reduce response size. Available fields: html, markdown, ocr, image, content, bbox, confidence, embed, chart_data. All default to true."Continue" (default) skips failed pages and continues processing the rest. "Fail" aborts the entire job on the first error.Response
GET /parse/{job_id} to poll status and retrieve results.api-key header is needed for the upload itself. Valid until expires_at.upload_url expires. Upload must complete before this time. The presigned URL is valid for 15 minutes by default; when expires_in is set (and positive), the upload URL lifetime is set to that same value, which can shorten or extend the window.Content-Type set to the MIME type inferred from file_name.Step-by-Step Guide
Step 1: Create the parse job
POST to/v2/parse/upload with your file name and configuration. The API returns a job_id and a short-lived presigned URL.
Step 2: Upload the file
Use theupload_url and upload_headers from the response to PUT your file. No API key is needed for this request.
Step 3: Poll for results
Once the upload completes, the job transitions fromAwaitingUpload → Queued → Processing → Succeeded. Poll the job through the standard GET /parse/{job_id} endpoint.
Standard and Large-File Upload Flows
Error Handling
Queued straight to Failed without ever reaching Processing: after the upload, the document is page-counted and rejected if it exceeds the page limit (default 2000 pages; split large documents first) or if the remaining page quota cannot cover it.Authorizations
Body
Request body for POST /v2/parse/upload. Configuration fields mirror the existing /parse multipart form fields.
Run a PII pre-check before parsing. When enabled, the document is scanned
for personally identifiable information before any extraction work happens.
If PII is found, the task is rejected and
no parsing occurs (the job ends in a failed state with a PII reason).
Defaults to false.
Export format(s) to generate after processing. Supported: ["docx", "markdown", "json"].
File format for exporting parsed results. When specified in a parse request,
the pipeline generates the requested export file after processing completes.
The exported file is available via the exports field in the task response.
docx, markdown, json Digitize charts into the numbers they were drawn from, attached to the Picture segment as chart_data. basic (default): no chart data. standard: fast and accurate chart data extraction. advanced: for the most complex and messiest charts; contact support to have it enabled for your organization (otherwise 403 with error.code = feature_not_enabled).
basic, standard, advanced Processing mode preset. fast (Fast), agentic_lite (Agentic Lite), or agentic (Agentic). Each mode applies a recommended processing configuration; see Processing Modes. Parameters you send explicitly take precedence over the mode. Omit to use the default configuration.
fast, agentic_lite, agentic Response
Upload URL created
Response from POST /v2/parse/upload.

