Skip to main content

File Uploads

The SDKs stream file uploads directly to the server in 64 KB chunks, so even large files are not fully buffered in memory.

Endpoints

For files larger than 10 MB, use the async endpoint with progress streaming so your application stays responsive during server-side processing.

Basic Upload

Upload with Processing Progress

After starting an upload, stream its progress in real time as the file is transferred and finalized:

Upload with Synchronous Processing

For smaller files where you don’t need progress tracking, use the synchronous endpoint. The file is still streamed to the server, but the request blocks until processing completes and returns the result directly.

Supported File Types

The API accepts common document formats including PDF, DOCX, XLSX, CSV, TXT, and JSON files. Maximum file size is 100 MB.

Error Handling

Upload errors are returned as standard API errors. When using progress streaming, errors are delivered as events: