File Upload Failed
Use this page when file de-identification fails in the dashboard or through the file API.
Symptoms
You may see:
- Upload does not complete.
- The dashboard shows a masking or upload error.
- The API returns
400 Bad Request. - The processed file is not returned.
- The file works locally but fails in the dashboard.
Likely Causes
Common causes include:
- The file type is unsupported.
- The file is corrupted or cannot be read.
- A
.docfile was uploaded where.docxis required. - A PDF does not contain extractable text.
- The request does not include the expected
filefield. - The API key does not have enough remaining credits.
- The file is too large or takes too long to process.
How to Check
- Confirm the file extension is supported.
- Open the file locally and confirm it is not corrupted.
- For Word files, convert
.docto.docx. - For PDFs, confirm the PDF has selectable text.
- Try a smaller sample file.
- Check remaining credits and request limits.
How to Fix
- Use a supported file type.
- Re-export or repair the file.
- Convert
.docfiles to.docx. - Use a text-based PDF rather than a scanned image-only PDF.
- Try a smaller file first.
- Confirm the request uses multipart form upload with a
filefield.