Reports

Create Saved Report

Changed on

Create a new saved report definition. Saved reports are SQL queries that can be executed later to generate full exports or samples.

If you just want to do ad-hoc queries, you should use the /reports/samples endpoint.

post/print-mail/v1/reports

Request

  • Base URL
    https://api.postgrid.com
  • URL
    https://api.postgrid.com/print-mail/v1/reports
  • Auth
    API key in header X-API-Key

Request body

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.

Response

The created 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.

Changes

  • c8fedcbd705eRevision changes
    • warning

      added the new internal_server_error enum value to the / response property for the response status

    • warning

      added the new not_found_error enum value to the / response property for the response status

    • warning

      added the new rate_limit_exceeded_error enum value to the / response property for the response status

    • warning

      added the new validation_error enum value to the / response property for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      removed subschema #1 subschema #2 from the response body anyOf list for the response status