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: