Skip to main content
PUT
Update a report runner

Authorizations

Authorization
string
header
required

Path Parameters

reportRunnerId
string
required

The Extole unique report runner identifier.

Body

application/json

Body of a PUT /v7/report-runners/{reportRunnerId} request.

type
enum<string>
required
Available options:
REFRESHING
component_ids
string[]
component_references
object[]
deliver_empty_reports_to_sftp
boolean | null
enabled
boolean
execution_policy
enum<string>
Available options:
AWAIT_DATA,
IMMEDIATE
formats
enum<string>[]
Available options:
CSV,
HEADLESS_CSV,
HEADLESS_PSV,
JSON,
JSONL,
PSV,
XLSX
merging_configuration
object
name
string
parameters
object
pause_info
object
report_name_pattern

Choose between static or dynamic report name pattern

report_type
string
scopes
enum<string>[]
Available options:
CLIENT_ADMIN,
CLIENT_SUPERUSER,
CONSUMER_PUBLIC
sftp_report_name_pattern

Choose between static or dynamic sftp report name pattern

sftp_server_id
string | null
tags
string[]
expiration_ms
integer<int64>

Response

Updated report runner.

component_ids
string[]
required
component_references
object[]
required
created_date
string
required

RFC 3339 or RFC 9557 date-time with a numeric UTC offset and an optional IANA time-zone suffix in square brackets. Precision up to milliseconds.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])(\[[^\]]+\])?$
Example:

"2025-10-24T02:00:00-07:00"

deliver_empty_reports_to_sftp
boolean
required
enabled
boolean
required
execution_policy
enum<string>
required
Available options:
AWAIT_DATA,
IMMEDIATE
formats
enum<string>[]
required
Available options:
CSV,
HEADLESS_CSV,
HEADLESS_PSV,
JSON,
JSONL,
PSV,
XLSX
id
string
required
read-only
merging_configuration
object
required
name
string
required
parameters
object
required
pause_info
object
required
paused
object
required
report_name_pattern
required

The report name pattern as configured: a literal value, or an expression (type:string) when defined dynamically.

report_type
string
required
report_type_name
string
required
scopes
enum<string>[]
required
Available options:
CLIENT_ADMIN,
CLIENT_SUPERUSER,
CONSUMER_PUBLIC
sftp_report_name_pattern
required

The sftp report name pattern as configured: a literal value, or an expression (type:string) when defined dynamically.

sftp_server_id
string | null
required
tags
string[]
required
type
enum<string>
required
Available options:
REFRESHING
updated_date
string
required

RFC 3339 or RFC 9557 date-time with a numeric UTC offset and an optional IANA time-zone suffix in square brackets. Precision up to milliseconds.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])(\[[^\]]+\])?$
Example:

"2025-10-24T02:00:00-07:00"

user_id
string
required
expiration_ms
integer<int64>
required