> ## Documentation Index
> Fetch the complete documentation index at: https://test-8ad8522e-feat-ai-sre.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Export issues as CSV

> Export the filtered RUM error tracking issues as a CSV file. The response is a `text/csv` stream delivered with `Content-Disposition: attachment` — it is not a JSON envelope; non-console callers can read the `X-Export-Total` and `X-Export-Truncated` response headers.

## Restrictions

| Aspect      | Value                                                                             |
| ----------- | --------------------------------------------------------------------------------- |
| Rate limits | **200 requests/day**; **100 requests/minute**; **10 requests/second** per account |
| Permissions | None — any valid `app_key` can call this operation                                |

## 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.


## OpenAPI

````yaml /api-reference/rum.openapi.en.json post /rum/issue/export
openapi: 3.1.0
info:
  description: >-
    Public HTTP API for the Flashduty incident management platform — incidents,
    notification templates, channels, schedules, monitors, RUM, and platform
    administration. Every operation is authenticated with an `app_key` query
    parameter issued from the Flashduty console under Account → APP Keys.
    Responses follow a uniform envelope: `{ request_id, data }` on success, `{
    request_id, error }` on failure.
  title: Flashduty Open API
  version: 1.0.0
servers:
  - description: Flashduty Open API
    url: https://api.flashcat.cloud
security:
  - AppKeyAuth: []
tags:
  - description: Manage Real User Monitoring (RUM) applications.
    name: RUM/Applications
  - description: Run RUM analytics queries over event data.
    name: RUM/Data query
  - description: Query and manage RUM error tracking issues and preset severity rules.
    name: RUM/Issues
  - description: >-
      Query RUM facet fields and their value distributions for building
      analytics filters.
    name: RUM/Facets
  - description: >-
      Manage and query RUM sourcemap files for browser, Android, and iOS error
      symbolication.
    name: RUM/Sourcemaps
  - description: Retrieve session replay metadata and recorded segments for RUM sessions.
    name: RUM/Session replay
  - description: >-
      Configure and inspect the rules that decide which RUM errors get ingested
      and stored for an application, including their edit history.
    name: RUM/Error ingestion rules
  - description: >-
      Manage per-application rules that assign a severity to matching front-end
      errors, plus their evaluation order and change history.
    name: RUM/Issue preset severity rules
  - description: Query the RUM resource record and current usage for the account.
    name: RUM/Resources
paths:
  /rum/issue/export:
    post:
      tags:
        - RUM/Issues
      summary: Export issues as CSV
      description: >-
        Export the filtered RUM error tracking issues as a CSV file. The
        response is a `text/csv` stream delivered with `Content-Disposition:
        attachment` — it is not a JSON envelope; non-console callers can read
        the `X-Export-Total` and `X-Export-Truncated` response headers.
      operationId: rum-issue-read-export
      requestBody:
        content:
          application/json:
            example:
              application_ids:
                - eWbr4xk3ZRnLabRa6unqwD
              console_origin: https://console.flashcat.cloud
              end_time: 1775961914595
              export_fields:
                - issue_id
                - error_type
                - error_message
                - status
                - error_count
                - session_count
                - last_seen_at
              orderby: updated_at
              start_time: 1772611200000
              statuses:
                - for_review
              time_zone: Asia/Shanghai
            schema:
              $ref: '#/components/schemas/RumIssueExportRequest'
        required: true
      responses:
        '200':
          content:
            text/csv:
              example: >-
                Issue ID,Error type,Error message,Status,Error count,Affected
                sessions,Last seen (Asia/Shanghai)

                NHEacQHi2DhXqobr9qPQz9,Error,Script
                error.,for_review,752,381,2026-04-12 10:43:59

                H8kZSmxiE7EgdyD4fCyyNa,Error,"API ERROR: We encountered an
                internal error | POST
                /api/access/logout",for_review,3,1,2026-04-03 12:41:24
              schema:
                description: >-
                  CSV file content. The header row matches the exported columns
                  in order; values are sanitized against spreadsheet formula
                  injection.
                type: string
          description: Success. CSV attachment, not a JSON envelope.
          headers:
            X-Export-Total:
              description: Total number of issues matching the filters, before the row cap.
              schema:
                format: int64
                type: integer
            X-Export-Truncated:
              description: >-
                `true` when more issues matched than the 100-row cap and the
                file was truncated.
              schema:
                type: boolean
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    RumIssueExportRequest:
      description: Filters for exporting RUM error tracking issues to CSV.
      properties:
        application_ids:
          description: Filter by application IDs. Get IDs via `POST /rum/application/list`.
          items:
            type: string
          type: array
        asc:
          description: Sort ascending when `true`; descending by default.
          type: boolean
        by_intersection:
          description: >-
            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.
          type: boolean
        console_origin:
          description: >-
            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).
          type: string
        dql:
          description: DQL query for advanced filtering. Cannot be used with `sql`.
          type: string
        end_time:
          description: >-
            End of the time range, Unix epoch milliseconds. Must be greater than
            `start_time`; maximum range: 183 days.
          format: int64
          type: integer
        error_required:
          description: >-
            If `true`, only export issues with at least one associated error
            event.
          type: boolean
        export_fields:
          description: >-
            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.


            | Value | Column content |

            |---|---|

            | `issue_id` | Issue ID |

            | `issue_url` | Console URL of the issue detail page (built from
            `console_origin`) |

            | `application_name` | Owning application name |

            | `service` | Service name |

            | `error_type` | Error type |

            | `error_message` | Error message |

            | `status` | Triage status |

            | `severity` | Severity |

            | `is_crash` | Whether the error caused a crash |

            | `error_count` | Error occurrence count |

            | `session_count` | Affected session count |

            | `first_seen_at` | First occurrence time (rendered in `time_zone`)
            |

            | `first_seen_version` | Application version at first occurrence |

            | `last_seen_at` | Most recent occurrence time (rendered in
            `time_zone`) |

            | `last_seen_version` | Application version at the most recent
            occurrence |

            | `versions` | All affected versions |

            | `suspected_cause` | Suspected cause category |

            | `resolved_at` | Resolution time (rendered in `time_zone`) |
          items:
            enum:
              - 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
            type: string
          type: array
        limit:
          description: >-
            Page size (1–100). Ignored by the export — the row cap is fixed at
            100.
          maximum: 100
          minimum: 1
          type: integer
        orderby:
          description: |-
            Sort field; defaults to `updated_at` when omitted.

            | Value | Meaning |
            |---|---|
            | `created_at` | Issue creation time |
            | `updated_at` | Last update time |
            | `session_count` | Affected session count |
            | `error_count` | Error occurrence count |
            | `severity` | Severity rank (`Critical` > `Warning` > `Info`) |
          enum:
            - created_at
            - updated_at
            - session_count
            - error_count
            - severity
          type: string
        p:
          description: >-
            Page number (1-based). Ignored by the export — the first 100
            matching rows are always read.
          minimum: 1
          type: integer
        sql:
          description: SQL-style query for advanced filtering. Cannot be used with `dql`.
          type: string
        start_time:
          description: Start of the time range, Unix epoch milliseconds.
          format: int64
          type: integer
        statuses:
          description: >-
            Filter by triage status; any other value is rejected with a
            parameter error.


            | Value | Meaning |

            |---|---|

            | `for_review` | Pending triage |

            | `reviewed` | Reviewed |

            | `ignored` | Ignored |

            | `resolved` | Resolved |
          items:
            enum:
              - for_review
              - reviewed
              - ignored
              - resolved
            type: string
          type: array
        suspected_causes:
          description: >-
            Filter by suspected cause category.


            | Value | Meaning |

            |---|---|

            | `api.failed_request` | API request failure (e.g. HTTP 4xx/5xx
            responses) |

            | `network.error` | Network connectivity error (offline, aborted
            requests, etc.) |

            | `code.exception` | Code exception (Syntax/Reference/Range and
            similar runtime errors) |

            | `code.invalid_object_access` | Invalid object access (e.g. reading
            a property of `undefined`/`null`) |

            | `code.invalid_argument` | Invalid argument passed to a function |

            | `unknown` | Cause could not be determined |
          items:
            enum:
              - api.failed_request
              - network.error
              - code.exception
              - code.invalid_object_access
              - code.invalid_argument
              - unknown
            type: string
          type: array
        team_ids:
          description: Filter by team IDs. Get team IDs via `POST /team/list`.
          items:
            format: int64
            type: integer
          type: array
        time_zone:
          description: >-
            IANA time zone used to render timestamps in the CSV, e.g.
            `Asia/Shanghai` or `UTC`. Default: `Asia/Shanghai`.
          type: string
      required:
        - start_time
        - end_time
      type: object
    ErrorResponse:
      description: Response envelope for errors. `error` is required; `data` is absent.
      properties:
        error:
          $ref: '#/components/schemas/DutyError'
        request_id:
          description: >-
            Unique trace ID of this request; include it when reporting issues so
            logs can be located.
          example: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4
          type: string
      required:
        - request_id
        - error
      type: object
    DutyError:
      description: >-
        Error payload inside the response envelope. Present only on non-2xx
        responses.
      properties:
        code:
          $ref: '#/components/schemas/ErrorCode'
        message:
          description: >-
            Human-readable error message, localized by the caller's
            Accept-Language. May contain field names, IDs, or other context from
            the failing request.
          example: The specified parameter template_id is not valid.
          type: string
      required:
        - code
        - message
      type: object
    ErrorCode:
      description: >-
        Flashduty error code enum. Every failed API response sets `error.code`
        to one of these stable wire strings. HTTP status is informational — the
        authoritative signal is the enum value.


        | Code | HTTP | Meaning |

        |---|---|---|

        | `OK` | 200 | Reserved — not returned on real errors. |

        | `InvalidParameter` | 400 | A required parameter is missing or failed
        validation. |

        | `BadRequest` | 400 | Generic 400 used when no more specific code fits.
        |

        | `InvalidContentType` | 400 | The `Content-Type` header is not
        `application/json`. |

        | `ResourceNotFound` | 400 | The referenced resource does not exist.
        Note: returned as HTTP 400, not 404 (historical choice). |

        | `NoLicense` | 400 | The feature is license-gated and no active license
        was found. |

        | `ReferenceExist` | 400 | Deletion blocked — other entities still
        reference this resource. |

        | `Unauthorized` | 401 | `app_key` is missing, invalid, or expired. |

        | `BalanceNotEnough` | 402 | Billing-gated operation with insufficient
        account balance. |

        | `AccessDenied` | 403 | Authenticated but lacking the permission
        required for this operation. |

        | `RouteNotFound` | 404 | The request URL path is not a known route. |

        | `MethodNotAllowed` | 405 | The HTTP method is not allowed on this
        otherwise-known path. |

        | `UndonedOrderExist` | 409 | An outstanding billing order blocks this
        new one. Wait and retry. |

        | `RequestLocked` | 423 | Operation temporarily locked due to repeated
        failures. |

        | `EntityTooLarge` | 413 | Request body exceeds the configured max size.
        |

        | `RequestTooFrequently` | 429 | Rate limit hit — API-global,
        per-account, or per-integration. |

        | `RequestVerifyRequired` | 428 | Second-factor verification required
        but not supplied. |

        | `DangerousOperation` | 428 | High-risk operation requires MFA
        verification. |

        | `InternalError` | 500 | Unhandled server-side error. Include
        `request_id` in the bug report. |

        | `ServiceUnavailable` | 503 | A backend dependency is unavailable. Try
        again later. |
      enum:
        - OK
        - InvalidParameter
        - BadRequest
        - InvalidContentType
        - ResourceNotFound
        - NoLicense
        - ReferenceExist
        - Unauthorized
        - BalanceNotEnough
        - AccessDenied
        - RouteNotFound
        - MethodNotAllowed
        - UndonedOrderExist
        - RequestLocked
        - EntityTooLarge
        - RequestTooFrequently
        - RequestVerifyRequired
        - DangerousOperation
        - InternalError
        - ServiceUnavailable
      example: InvalidParameter
      type: string
      x-enumDescriptions:
        AccessDenied: Authenticated but lacking the permission required for this operation.
        BadRequest: Generic 400 used when no more specific code fits.
        BalanceNotEnough: Billing-gated operation with insufficient account balance.
        DangerousOperation: High-risk operation requires MFA verification.
        EntityTooLarge: Request body exceeds the configured max size.
        InternalError: Unhandled server-side error. Include `request_id` in the bug report.
        InvalidContentType: The `Content-Type` header is not `application/json`.
        InvalidParameter: A required parameter is missing or failed validation.
        MethodNotAllowed: The HTTP method is not allowed on this otherwise-known path.
        NoLicense: The feature is license-gated and no active license was found.
        OK: Reserved — not returned on real errors.
        ReferenceExist: Deletion blocked — other entities still reference this resource.
        RequestLocked: Operation temporarily locked due to repeated failures.
        RequestTooFrequently: Rate limit hit — API-global, per-account, or per-integration.
        RequestVerifyRequired: Second-factor verification required but not supplied.
        ResourceNotFound: >-
          The referenced resource does not exist. Note: returned as HTTP 400,
          not 404 (historical choice).
        RouteNotFound: The request URL path is not a known route.
        ServiceUnavailable: A backend dependency is unavailable. Try again later.
        Unauthorized: '`app_key` is missing, invalid, or expired.'
        UndonedOrderExist: An outstanding billing order blocks this new one. Wait and retry.
  responses:
    BadRequest:
      content:
        application/json:
          examples:
            missingParameter:
              value:
                error:
                  code: InvalidParameter
                  message: The specified parameter is not valid.
                request_id: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Invalid request — usually a missing or malformed parameter.
    Unauthorized:
      content:
        application/json:
          examples:
            missingAppKey:
              value:
                error:
                  code: Unauthorized
                  message: You are unauthorized.
                request_id: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Missing or invalid app_key.
    TooManyRequests:
      content:
        application/json:
          examples:
            rateLimited:
              value:
                error:
                  code: RequestTooFrequently
                  message: Request too frequently.
                request_id: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: >-
        Rate limit hit. Either the global API limit, a per-account limit, or a
        per-integration limit.
    ServerError:
      content:
        application/json:
          examples:
            internal:
              value:
                error:
                  code: InternalError
                  message: >-
                    We encountered an internal error, and it has been reported.
                    Please try again later.
                request_id: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Unexpected server-side error. Include the request_id when reporting.
  securitySchemes:
    AppKeyAuth:
      description: >-
        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.
      in: query
      name: app_key
      type: apiKey

````