Skip to main content
POST
/
v1
/
uploads
/
{upload_id}
/
process
Parse an uploaded file into structured HTML with chunk IDs for targeted AI editing.
curl --request POST \
  --url https://api.example.com/v1/uploads/{upload_id}/process \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "<string>",
  "filename": "<string>",
  "parse_mode": "document"
}
'
{
  "session_id": "<string>",
  "filename": "<string>",
  "status": "<string>",
  "parse_mode": "<string>",
  "html": "<string>",
  "chunks_count": 123,
  "version_id": "<string>",
  "job_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
authorization
string | null

Path Parameters

​
upload_id
string
required

The upload_id returned by request_upload_url.

Body

application/json
​
session_id
string
required

Session ID to load this document/attachment into.

Maximum string length: 200
​
filename
string
required

Same filename passed to request_upload_url.

Maximum string length: 255
​
parse_mode
enum<string>
default:document

'document' = parse and load as the active editable doc (returns parsed HTML); 'attachment' = process asynchronously as AI-searchable reference (returns job_id to poll).

Available options:
document,
attachment

Response

Successful Response

​
session_id
string
required
​
filename
string
required
​
status
string
required
​
parse_mode
string
required
​
html
string | null
​
chunks_count
integer | null
​
version_id
string | null
​
job_id
string | null