Troubleshoot Uploads
Fix common issues with uploading files.
Add --verbose (or -v) before the command name to see the SDK's INFO and DEBUG logs. It's a global option, so it must come before the command, not after.
Files Uploaded But Don't Appear
Ingestion lags the upload. Check the session status:
haystack-enterprise list-upload-sessions
haystack-enterprise get-upload-session <session-id>
An upload session left open expires after 24 hours, and files only start ingesting when it closes.
Some Files Were Skipped
By default, upload sends every supported type and skips unsupported types instead of failing the run. If you passed --use-type, only those types are uploaded. For details, see Supported File Types.
Duplicates in the Workspace
The default write mode is KEEP, which uploads a same-named file alongside the existing one. Use --write-mode OVERWRITE to replace instead.
Related Information
Was this page helpful?