uploads
mcp
uploads

Parse an uploaded file into structured HTML with chunk IDs for targeted AI editing.

Fetches the file uploaded via request_upload_url and runs the same parsing pipeline as upload_document_base64: every paragraph, heading, table, row, and cell gets a unique chunk ID, enabling targeted structural edits via chat ("remove row 3 of the pricing table" works), with tables, borders, shading, alternating row colors, fonts, and inline styling preserved on edit and export. By default the response is compact (metadata only, no document body) to keep your context small — the document is loaded into the session and you edit it via chat; pass return_html=true if you need the parsed HTML inline. Uploading and parsing is NOT itself a billable operation — you are charged only when the AI edits the document. Specify parse_mode='document' to load as the active editable document, or parse_mode='attachment' to load as a read-only AI-searchable reference.

post/v1/uploads/{upload_id}/process

Request

  • Base URL: https://api.superdocs.app
  • URL: https://api.superdocs.app/v1/uploads/{upload_id}/process
  • Auth: HTTP bearer

Path parameters

upload_idstring required

The upload_id returned by request_upload_url.

Headers

authorizationstring nullable

Request body

session_idstring required

Session ID to load this document/attachment into. Must match the chat/async session-id format — letters, digits, '_', '-', '.' only (no ':'); max 256 chars.

filenamestring required

Same filename passed to request_upload_url.

parse_mode'document' | 'attachment'

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

return_htmlboolean

When false (default), the response is compact — metadata only (chunks_count, version_id, page_setup), no document body — to keep your context small; the document is loaded into the session and you edit it via chat. Set true only if you actually need the parsed HTML returned inline.

Response

Successful Response

htmlstring nullable
session_idstring required
filenamestring required
chunks_countinteger nullable
version_idstring nullable
job_idstring nullable
statusstring required
parse_modestring required
page_setupobject nullable
warningsobject[] nullable

Changes

No recorded changes to this operation across all 1 revision of this API.