Skip to main content

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 .doc file was uploaded where .docx is required.
  • A PDF does not contain extractable text.
  • The request does not include the expected file field.
  • The API key does not have enough remaining credits.
  • The file is too large or takes too long to process.

How to Check

  1. Confirm the file extension is supported.
  2. Open the file locally and confirm it is not corrupted.
  3. For Word files, convert .doc to .docx.
  4. For PDFs, confirm the PDF has selectable text.
  5. Try a smaller sample file.
  6. Check remaining credits and request limits.

How to Fix

  • Use a supported file type.
  • Re-export or repair the file.
  • Convert .doc files 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 file field.