v1

latestOpenAPI 3.0.02026-07-14106203730.9 KB

Reports

Create a Report Export

Create a new export job for a saved report. This runs the report's query asynchronously and generates a downloadable CSV file with the full results. Your queries can run for up to 13 minutes the resulting file can be up to 100mb large.

post/print-mail/v1/reports/{reportID}/exports

Path parameters

reportIDstring required

The ID of the report to export.

Request body

paramsstring[]

Optional parameters to bind to the SQL query of the associated report.

descriptionstring

An optional user-friendly description for the export.

metadataobject

Optional key-value metadata associated with the export.

Response

The created ReportExport object, representing the pending job.

idstring required

Unique identifier for the report export.

object'report_export' required

Always report_export.

liveboolean required

Indicates if the export is associated with the live or test environment.

paramsstring[]

Optional parameters to bind to the SQL query of the associated report.

descriptionstring

An optional user-friendly description for the export.

metadataobject

Optional key-value metadata associated with the export.

outputURLstring uri

A signed URL to download the exported data (CSV format). Available when generation is complete and successful.

failureMessagestring

If export generation failed, this contains the error message.

truncatedToBytesinteger

If the output was truncated, indicates the byte limit reached.

sizeInBytesinteger

The size of the generated export file in bytes.

rowCountinteger

The number of rows in the exported data.

createdAtstring date-time required

Timestamp when the export was created.

updatedAtstring date-time required

Timestamp when the export was last updated (e.g., finished generation).