Download an exported file

POST https://api.sigmacomputing.com/v2/query/{queryId}/download

After making a request to the /v2/workbooks/{workbookId}/export endpoint, you can use this endpoint to download the exported file using the queryId returned in the response. See Export data from a workbook.

Usage Notes

The export must be ready to download before you can download the results. The endpoint returns an error if the query is still processing or if the queryId is invalid. Query results are typically available for a limited time, so make sure to download query results while they are available.

Specify the file format when you make the export request. You cannot specify the file format when you download the file.

Usage Scenarios

• Scheduled Reporting: Automate the downloading of reports generated on a scheduled basis.
• Data Analysis: Retrieve large datasets for local analysis in external tools not integrated directly with Sigma.

Best Practices

• Monitor the status of your query before attempting a download to make sure it is ready. For a code example, see Export to CSV with Date Range Parameters.
• Handle errors gracefully in your application, providing users with clear messages regarding the status of their requested downloads.