Skip to main content
The Upload endpoint transfers documents to Reducto, returning a unique reducto:// identifier you can pass to any downstream endpoint: Classify, Parse, Split, Extract, or Edit.
Files over 100MB? Use the presigned URL method which supports files up to 5GB.

When to Use Upload

Supported File Types

Multi-page images: TIFF files with multiple pages are processed as multi-page documents.
Email files: Reducto parses the headers (subject, from, to, date) and the message body. Reducto lists attachments by name or count but does not parse them, so upload them as separate files.
Image dimension limits: The dimension limit for images is 50 megapixels total (e.g., ~8200×6100), with a per-axis maximum of 15,000 pixels.

Quick Start


URL Passthrough

If your document is already accessible via URL, skip the upload step entirely:
This works with:
  • Public URLs (https://…)
  • Presigned S3, GCS, or Azure Blob URLs
  • Any URL that returns the file directly when accessed

Response Format

Files expire after 24 hours. The reducto:// URI becomes invalid after expiration. Re-upload if you need to process the file again.
Reuse the file_id: You can process the same document multiple times with different configurations without re-uploading — just use the same file_id.

Common Questions

For files over 100MB, see Uploading Large Files.
Files expire 24 hours after upload. The reducto:// URI becomes invalid after expiration.Need to process the same file again after 24 hours? Re-upload it.
The Upload endpoint accepts one file per request. For batch uploads, make parallel requests:
See our batch processing guide for production patterns.
Yes. Use DELETE /upload/{file_id} to remove an uploaded file immediately. Files are also automatically deleted within 24 hours under Reducto’s ZDR policy for Growth tier and above. See Deleting Jobs & Uploads for details.

Troubleshooting

Error: Unsupported file formatFix: Check that your file extension matches the supported file types. When uploading programmatically, ensure the filename includes the extension.
Error: File size exceeds maximum allowedFix: Direct upload is limited to 100MB. For larger files, use the presigned URL method which supports up to 5GB.
Error: Request timeoutFix:
  • For files approaching 100MB, consider using presigned URL upload
  • Check your network connection
  • Implement retry logic with exponential backoff

Next Steps

Parse

Convert documents into text, tables, and figures.

Extract

Pull specific fields into structured JSON using a schema.

Split

Divide documents into sections for targeted processing.

Large Files

Upload files over 100MB using presigned URLs.