Document Intelligence · Errors
Beyond the global error vocab — see Errors (global).
Upload
| HTTP | Error | Meaning |
|---|---|---|
| 400 | file required | Missing multipart file field. |
| 413 | file too large: max 20 MB | Split client-side or contact us for enterprise tier. |
| 415 | unsupported media type | We accept PDF, JPEG, PNG, HEIC, WebP, TIFF only. |
| 422 | password required | PDF is encrypted; pass pdfPassword in form data. |
| 422 | invalid password | pdfPassword doesn't unlock the file. |
Type / template
| HTTP | Error | Meaning |
|---|---|---|
| 400 | unknown type: <slug> | Not a built-in type and not a template in your org. |
| 404 | template not found | templateId is wrong or belongs to another org. |
| 409 | template slug already exists | Slugs unique per org. |
Processing
| HTTP | Error | Meaning |
|---|---|---|
| 503 | pipeline backpressure | Async queue temporarily full. We retry the job. Your upload is queued. |
Extractions
| HTTP | Error | Meaning |
|---|---|---|
| 400 | fields object empty | Manual correction must include at least one field. |
| 409 | document status not extracted | Can't correct a doc that's still queued or failed. |
Erase
| HTTP | Error | Meaning |
|---|---|---|
| 400 | reason required (min 20 chars) | Audit policy. |
| 409 | document already erased | Idempotent — refuse to erase again. |
Webhooks
| HTTP | Error | Meaning |
|---|---|---|
| 400 | events: at least one required | Empty events array. |
| 400 | url must be https | Webhook URLs must be HTTPS (sandbox allows localhost). |