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.
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.
Files are automatically deleted after 24 hours. There’s no manual delete endpoint — files are purged automatically for security and compliance.

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.