Skip to main content
POST
Export issues as CSV

Restrictions

Usage

  • The response is a text/csv stream delivered with Content-Disposition: attachment — it is not wrapped in the standard envelope. The filename is rum-issues-<timestamp>.csv, stamped in the requested time_zone. Read X-Export-Total and X-Export-Truncated response headers instead of a body field.
  • The export reads the first 100 matching rows (ExportMaxRows); X-Export-Truncated is true when more issues match. p and limit are ignored.
  • The request filters are exactly those of POST /rum/issue/list — an export is “what I am looking at, as a file”.
  • export_fields names the CSV columns in the order they appear. Unknown keys are rejected with a parameter error; an empty array uses the default column set.
  • time_zone must be a valid IANA zone name (e.g. Asia/Shanghai, UTC); timestamps are rendered in that zone and time columns carry the zone in their header. Invalid names are rejected.
  • console_origin is used to build the issue_url column; the service cannot infer it (SaaS, on-premises and dev releases answer on different origins).
  • Every call is recorded in the account’s audit log with the caller’s member ID, request payload, and resulting error (if any). Do not put secrets in request fields.

Authorizations

app_key
string
query
required

App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.

Body

application/json

Filters for exporting RUM error tracking issues to CSV.

start_time
integer<int64>
required

Start of the time range, Unix epoch milliseconds.

end_time
integer<int64>
required

End of time range, millisecond timestamp. Maximum range: 183 days.

application_ids
string[]

Filter by application IDs. Get IDs via POST /rum/application/list.

dql
string

DQL query for advanced filtering. Cannot be used with sql.

sql
string

SQL-style query for advanced filtering. Cannot be used with dql.

statuses
enum<string>[]

Filter by status; only the enum values are accepted — any other value is rejected with a parameter error.

Available options:
for_review,
reviewed,
ignored,
resolved
suspected_causes
enum<string>[]

Filter by suspected cause; see the enum for valid values.

Available options:
api.failed_request,
network.error,
code.exception,
code.invalid_object_access,
code.invalid_argument,
unknown
team_ids
integer<int64>[]

Filter by team IDs. Get team IDs via POST /team/list.

p
integer

Page number (1-based). Ignored by the export — the first 100 matching rows are always read.

limit
integer

Page size (1–100). Ignored by the export — the row cap is fixed at 100.

orderby
enum<string>

Sort field; defaults to updated_at when omitted.

Available options:
created_at,
updated_at,
session_count,
error_count,
severity
asc
boolean

Sort ascending when true; descending by default.

error_required
boolean

If true, only export issues with at least one associated error event.

by_intersection
boolean

When true, match by time-range overlap: export issues still active within the window (last_seen_timestamp >= start_time) even if created before it. Default false exports only issues created inside the window.

export_fields
enum<string>[]

CSV columns to export, in the order they appear. Unknown keys are rejected with a parameter error; an empty array uses the default column set.

Available options:
issue_id,
issue_url,
application_name,
service,
error_type,
error_message,
status,
severity,
is_crash,
error_count,
session_count,
first_seen_at,
first_seen_version,
last_seen_at,
last_seen_version,
versions,
suspected_cause,
resolved_at
console_origin
string

Console origin used to build the issue_url column, e.g. https://console.flashcat.cloud. The service cannot infer it (SaaS, on-premises and dev releases answer on different origins).

time_zone
string

IANA time zone used to render timestamps in the CSV, e.g. Asia/Shanghai or UTC. Default: Asia/Shanghai.

Response

Success. CSV attachment, not a JSON envelope.

CSV file content. The header row matches the exported columns in order; values are sanitized against spreadsheet formula injection.