Request modes
AI capability paths stay the same; the request prefix and upload workflow change.
| Mode | Endpoint example | Best for |
|---|---|---|
| Sync | POST /v2/process/idp/documentExtract | Small files and interactive demos |
| Async | POST /v2/processAsync/idp/documentExtract | Large files, batch jobs, backend queues |
| Presigned | POST /v2/presignedUrl/idp/documentExtract | Direct browser upload to object storage and stricter security requirements |
Async polling
Start polling every 2-5 seconds, then back off for large files or busy queues. Stop after your business timeout and let the user retry later.
| State | Meaning |
|---|---|
processing | The task is running |
completed | The result is ready |
failed | Check failureCode / failureReason |
expired | The task or download link has expired |
Webhook
Pass callbackUrl for async tasks if you want the service to notify your endpoint when processing completes. See Webhook events.