v34

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-09194386949.7 KB

Parse

Upload File Multipart

Upload and parse a file using multipart/form-data.

Send the file as a file field and parsing configuration as a configuration JSON string field.

The job runs asynchronously. Poll GET /parse/{job_id} with expand to retrieve results.

post/api/v2/parse/upload

Query parameters

project_idstring uuid nullable

organization_idstring uuid nullable

Cookies

sessionstring nullable

Response

Successful Response

idstring required

Unique parse job identifier

created_atstring date-time nullable

Creation datetime

updated_atstring date-time nullable

Update datetime

project_idstring required

Project this job belongs to

status'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required

Current job status: PENDING, RUNNING, COMPLETED, FAILED, or CANCELLED

error_messagestring nullable

Error details when status is FAILED

namestring nullable

Optional display name for this parse job

tierstring nullable

Parsing tier used for this job

Example response

{
  "id": "pjb-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "project_id": "prj-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "name": "Q4 Financial Report",
  "tier": "fast"
}