PUT
/
reports
/
{report_id}

This endpoint requires the reports.write scope.

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

report_id
string
required

The unique ID for a report.

Body

application/json

Request body to update a report.

name
string

The name of the report.

Maximum length: 100
description
string | null

The description of the report.

Maximum length: 1000
schedule_enabled
boolean

Indicates whether the report's scheduling is enabled. This value can only be set to true if this is a recurring report.

When this value is set to true, the report will be executed at the next_execution_at date and time.

When this value is set to false, future executions of the report are paused until this value is set to true again.

If scheduling is enabled after being disabled, then the next_execution_at value is updated if and only if its current value is a past date-time. The next_execution_at value is then set to the next closest date-time in the future depending on the values of schedule and schedule_timezone.

Response

200 - application/json

A report record.

type
enum<string>

The type of this resource. Is always report.

Available options:
report
id
string

The unique identifier for this report.

merchant_account_id
string

The unique ID for a merchant account.

name
string

The name of this report.

Maximum length: 100
creator_id
string | null

The unique identifier for the creator of this report.

creator_display_name
string | null

The name of the creator of this report.

Maximum length: 1000
creator_type
enum<string> | null

The type of the creator of this report.

Available options:
user,
private_key
created_at
string

The date and time this report was created in our system.

updated_at
string

The date and time this report was last updated.

next_execution_at
string | null

The date and time this report will next be executed, provided that schedule_enabled is true. This value is null if this is a one-off report.

description
string | null

The description of this report.

Maximum length: 1000
schedule
enum<string>

Specifies the schedule of this report.

If this is a one-off report, this value is once.

If this is a recurring report, this value is set to the frequency by which the report will be executed. For example, a monthly schedule means that this report will be periodically executed at the start of each month.

Note that a weekly schedule means that the report is executed at the start of every Monday.

Available options:
daily,
monthly,
once,
weekly
schedule_enabled
boolean

Indicates whether this report's scheduling is enabled. This value can only be set to true if this is a recurring report.

When this value is set to true, this report will be executed at the next_execution_at date and time.

When this value is set to false, future executions of this report are paused until this value is set to true again.

schedule_timezone
string

The time zone in which the next execution will be scheduled. This value is used to calculate this report's next_execution_at value and is only relevant if this is a recurring report. This time zone is also used to calculate the timestamp range for reports that use date-time placeholders. Date-time placeholders are dynamic timestamps that change with every report execution.

spec
object

The specifications of this report.

latest_execution
object

Details of the latest execution of this report.

Was this page helpful?

New reportList all report executions