- Keep an audit trail of what your users actually sent you.
- Investigate a support request (“this is not what I uploaded”).
- Re-process or compare the source file against the imported records.
The original file is different from the imported file. The imported file
is a CSV of the final records, mapped to your importer’s columns. The original
file is the user’s spreadsheet, untouched.
When an original file is available
Original files are saved automatically. There is no extra code to write. An import has an original file when:- Incognito Mode is off for the importer. This is the default.
- The importer is launched with a session token (
importer.getSessionToken), as shown in Sessions and Embedding. Older setups that pass only an API key tonew FuseImporter(apiKey, importerSlug)do not save original files. - The user uploaded a file. Data typed in with “Enter data manually” has no original file.
- The file is a CSV (up to 100 MB), XLS or XLSX (up to 50 MB).
Download from the dashboard
- Open the Imports page in the Fuse Dashboard.
- Hover over the import you want.
- Click Download original.
Download with the API
1. Find imports that have an original file
List Imports returns anoriginal_file_available field for each import:
2. Get a download link
Get Import returns the file name and a download link:original_file_url is null when the import has no original file.
The original file is saved separately from the records, so it can become
available a little after the import itself, especially for large files.
If
original_file_url is null right after an import completes, try again a
bit later.3. Download the file
Send a regularGET request to original_file_url. No Authorization header is needed: the link itself grants access.
Example: save the original file after each import
Combine this with a Status Webhook to copy original files into your own storage when an import completes. Because the original file can arrive shortly after the import, check a few times before giving up:original_file_available: true that you have not saved yet.
How long files are kept
The original file is kept as long as its import. When an import is deleted, from the dashboard or by your organization’s data retention period, its original file is deleted with it. If you need files for longer, download them to your own storage (see the example above).What your users see
Saving the original file happens in the background while your users work in the importer. It does not slow down or block their import.- If the copy fails, the importer shows a small banner explaining why. When the problem is temporary (for example, a network issue), the banner has a Retry upload button. Either way the user can continue: their records are imported regardless.
- If the user closes the importer while the copy is still in progress, the importer shows a dialog and closes by itself once the file is saved. From that dialog the user can:
- Close without original file at any time, without waiting.
- Retry, if the copy failed for a temporary reason.
- Return to importer, if they have not submitted their data yet.