v7

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-121372601.5 MB
Reports

Update Report

Update an existing saved report definition. You can change the query, description, or metadata.

post/print-mail/v1/reports/{id}

Path parameters

idstring required

The ID of the report to update.

Request body

sqlQuerystring

The SQL query defining the report.

descriptionstring nullable

An optional user-friendly description for the report. Set to null to remove.

metadataobject nullable

Optional key-value metadata associated with the report. Set to null to remove.

Response

The updated Report object.

idstring required

Unique identifier for the report.

object'report' required

Always report.

liveboolean required

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

sqlQuerystring required

The SQL query defining the report.

descriptionstring

An optional user-friendly description for the report.

metadataobject

Optional key-value metadata associated with the report.

createdAtstring date-time required

Timestamp when the report was created.

updatedAtstring date-time required

Timestamp when the report was last updated.