> ## Documentation Index > Fetch the complete documentation index at: https://docs.flashduty.com/llms.txt > Use this file to discover all available pages before exploring further. # List preset severity rule history > Return the change history of preset severity rules for a RUM application. ## Restrictions | Aspect | Value | | ----------- | ------------------------------------------------------------- | | Rate limits | **1,000 requests/minute**; **50 requests/second** per account | | Permissions | None — any valid `app_key` can call this operation | ## Usage * Each entry is an application-level snapshot of every rule as it existed immediately *before* the mutation that produced it — not a diff. A fresh snapshot is written before every create/update/enable/disable/delete/reorder/revert call that actually changes something — an `update` carrying none of the mutable fields returns success without writing one — so `version=1` is typically an empty rule set captured just before the first rule was ever created. * `rules` items carry the full internal row (including `account_id`, `created_by`, `id`, `deleted_at`), which is a wider shape than the one returned by `rules/list`. * `limit` defaults to 20 and is silently capped at 100 rather than rejected. * `orderby` accepts only `updated_at` or `version`; any other value (including omitted) falls back to `updated_at` rather than erroring. * Results sort descending by default; pass `asc=true` for ascending order. ## OpenAPI ````yaml /api-reference/rum.openapi.en.json post /rum/issue/preset-severity/rules/history/list openapi: 3.1.0 info: title: Flashduty Open API 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. version: 1.0.0 servers: - url: https://api.flashcat.cloud description: Flashduty Open API security: - AppKeyAuth: [] tags: - name: RUM/Applications description: Manage Real User Monitoring (RUM) applications. - name: RUM/Data query description: Run RUM analytics queries over event data. - name: RUM/Issues description: Query and manage RUM error tracking issues and preset severity rules. - name: RUM/Facets description: >- Query RUM facet fields and their value distributions for building analytics filters. - name: RUM/Sourcemaps description: >- Manage and query RUM sourcemap files for browser, Android, and iOS error symbolication. - name: RUM/Session replay description: Retrieve session replay metadata and recorded segments for RUM sessions. - name: RUM/Error ingestion rules description: >- Configure and inspect the rules that decide which RUM errors get ingested and stored for an application, including their edit history. - name: RUM/Issue preset severity rules description: >- Manage per-application rules that assign a severity to matching front-end errors, plus their evaluation order and change history. - name: RUM/Resources description: Query the RUM resource record and current usage for the account. paths: /rum/issue/preset-severity/rules/history/list: post: tags: - RUM/Issue preset severity rules summary: List preset severity rule history description: >- Return the change history of preset severity rules for a RUM application. operationId: rum-issue-preset-severity-rules-history-list requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RumPresetSeverityRuleHistoryListRequest' example: application_id: WoyQQ3BohkdtPivubEvE8o p: 0 limit: 20 responses: '200': description: Success content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - type: object properties: data: $ref: >- #/components/schemas/RumPresetSeverityRuleHistoryListResponse example: request_id: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4 data: total: 3 has_next_page: false items: - rules: - account_id: 3790925372131 application_id: WoyQQ3BohkdtPivubEvE8o rule_id: n8mZQ2VbXk4wPRs6DfC9Ay rule_name: Known noisy browser extension errors description: Downgrade known extension errors to Info filters: - - key: error.error_message oper: IN vals: - >- /^ResizeObserver loop.*|.*chrome-extension:\/\/.*/ severity: Info priority: 1 status: enabled created_by: 3790925372131 updated_by: 3790925372131 id: 4820 deleted_at: 0 created_at: 1785744052160 updated_at: 1785744052160 - account_id: 3790925372131 application_id: WoyQQ3BohkdtPivubEvE8o rule_id: TAHUYnQmXKzgMS4TFVUKvz rule_name: Critical crash spikes description: Escalate production crashes to Critical severity filters: - - key: error.env oper: IN vals: - production - key: error.is_crash oper: IN vals: - 'true' severity: Critical priority: 2 status: enabled created_by: 3790925372131 updated_by: 3790925372131 id: 4821 deleted_at: 0 created_at: 1785830452160 updated_at: 1785830452160 version: 3 updated_by: 2476444212131 updated_by_name: Alice Chen updated_at: 1785916852160 - rules: - account_id: 3790925372131 application_id: WoyQQ3BohkdtPivubEvE8o rule_id: n8mZQ2VbXk4wPRs6DfC9Ay rule_name: Known noisy browser extension errors description: Downgrade known extension errors to Info filters: - - key: error.error_message oper: IN vals: - >- /^ResizeObserver loop.*|.*chrome-extension:\/\/.*/ severity: Info priority: 1 status: enabled created_by: 3790925372131 updated_by: 3790925372131 id: 4820 deleted_at: 0 created_at: 1785744052160 updated_at: 1785744052160 version: 2 updated_by: 3790925372131 updated_by_name: Bob Zhang updated_at: 1785830452160 - rules: [] version: 1 updated_by: 3790925372131 updated_by_name: Bob Zhang updated_at: 1785744052160 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' components: schemas: RumPresetSeverityRuleHistoryListRequest: type: object required: - application_id description: Filters for listing preset severity rule change history. properties: application_id: type: string description: >- RUM application ID. Get application IDs via `POST /rum/application/list`. p: type: integer minimum: 0 default: 0 description: Zero-based page number. limit: type: integer default: 20 maximum: 100 description: >- Page size. Values <= 0 default to 20; values above 100 are capped at 100. orderby: type: string enum: - updated_at - version default: updated_at description: >- Sort column. Any other value (including omitted) falls back to `updated_at`. asc: type: boolean default: false description: Sort ascending when true; results are descending by default. SuccessEnvelope: type: object description: >- Success response envelope. On every 2xx response, `request_id` identifies the call (also mirrored in the `Flashcat-Request-Id` header) and `data` holds the endpoint-specific payload. Failure responses use a different shape — see `ErrorResponse`. properties: request_id: type: string description: >- Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues. example: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4 data: description: Endpoint-specific payload. See each operation's 200 response schema. required: - request_id - data RumPresetSeverityRuleHistoryListResponse: type: object required: - total - has_next_page - items description: Paginated list of preset severity rule history snapshots. properties: total: type: integer format: int64 description: Total number of history snapshots for the application. has_next_page: type: boolean description: Whether another page is available after this one. items: type: array items: $ref: '#/components/schemas/RumPresetSeverityRuleHistoryItem' description: Preset severity rule history snapshots of the current page. RumPresetSeverityRuleHistoryItem: type: object description: >- A versioned, application-level snapshot of all preset severity rules at the time of a change. required: - rules - version - updated_by - updated_by_name - updated_at properties: rules: type: array items: $ref: '#/components/schemas/RumPresetSeverityRuleHistorySnapshotRule' description: >- Full rule set captured immediately before the mutation that produced this snapshot. Empty for the very first snapshot. version: type: integer description: Monotonically increasing snapshot version number, starting at 1. updated_by: type: integer format: int64 description: Member ID who triggered the mutation this snapshot precedes. updated_by_name: type: string description: Display name of `updated_by` at the time of the change. updated_at: type: integer format: int64 description: Unix timestamp in milliseconds when the snapshot was written. ErrorResponse: type: object description: Response envelope for errors. `error` is required; `data` is absent. properties: request_id: type: string example: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4 description: >- Unique trace ID of this request; include it when reporting issues so logs can be located. error: $ref: '#/components/schemas/DutyError' required: - request_id - error RumPresetSeverityRuleHistorySnapshotRule: type: object description: >- The full internal row for one rule as stored in a history snapshot — not the trimmed shape returned by `rules/list`. Includes internal bookkeeping fields (`account_id`, `created_by`, `id`, `deleted_at`) because the snapshot serializes the raw database row verbatim. required: - account_id - application_id - rule_id - rule_name - description - filters - severity - priority - status - created_by - updated_by - id - deleted_at - created_at - updated_at properties: account_id: type: integer format: int64 description: Account ID the rule belongs to. application_id: type: string description: RUM application ID the rule belongs to. rule_id: type: string description: Unique rule ID. rule_name: type: string description: Rule display name. description: type: string description: Rule description. May be empty. filters: type: array description: >- OR-of-ANDs filter structure: the outer array is OR'd, each inner array is AND'd. A rule matches an error when at least one inner AND-group fully matches. items: type: array items: $ref: '#/components/schemas/RumPresetSeverityRuleFilterCondition' severity: type: string enum: - Critical - Warning - Info description: Severity assigned to errors matching this rule. priority: type: integer description: Evaluation order at snapshot time; `1` is highest precedence. status: type: string enum: - enabled - disabled description: Rule status at snapshot time. created_by: type: integer format: int64 description: Member ID who originally created the rule. updated_by: type: integer format: int64 description: Member ID who last updated the rule as of snapshot time. id: type: integer format: uint64 description: >- Internal auto-increment row ID. Not stable across a history revert — reverting reinserts rows with new IDs. deleted_at: type: integer format: int64 description: >- Unix timestamp in milliseconds the rule was soft-deleted; `0` means not deleted. Always `0` in practice, since deleted rules are excluded before a snapshot is taken. created_at: type: integer format: int64 description: Unix timestamp in milliseconds when the rule was created. updated_at: type: integer format: int64 description: Unix timestamp in milliseconds when the rule was last updated. DutyError: type: object description: >- Error payload inside the response envelope. Present only on non-2xx responses. properties: code: $ref: '#/components/schemas/ErrorCode' message: type: string 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. required: - code - message RumPresetSeverityRuleFilterCondition: type: object description: One filter condition within an AND group. required: - key - oper - vals properties: key: type: string enum: - error.usr_id - error.usr_email - error.view_url - error.view_url_path - error.error_type - error.error_message - error.env - error.service - error.device_type - error.os_name - error.browser_name - error.is_crash description: >- Filter attribute key. Only these Error-level attributes are supported for preset severity rules. | Value | Meaning | |---|---| | `error.usr_id` | User ID | | `error.usr_email` | User email | | `error.view_url` | Full URL of the page where the error occurred | | `error.view_url_path` | URL path of the page where the error occurred | | `error.error_type` | Error type | | `error.error_message` | Error message | | `error.env` | Environment (e.g. production/staging) | | `error.service` | Service name | | `error.device_type` | Device type | | `error.os_name` | Operating system name | | `error.browser_name` | Browser name | | `error.is_crash` | Whether the error is a crash (boolean) | oper: type: string enum: - IN - NOTIN description: >- Match semantics: `IN` matches when the field's value matches any of `vals`; `NOTIN` matches when it matches none of them (and matches when the field is absent). vals: type: array minItems: 1 items: type: string description: >- Values to match against. Each entry supports exact string match, wildcard (`*`/`?`), regex (wrap in `/.../`), CIDR (`cidr:10.0.0.0/8`) for IP-shaped values, or numeric comparison (`num:gt:100`, `num:le:50`, etc.). ErrorCode: type: string 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 x-enumDescriptions: OK: Reserved — not returned on real errors. InvalidParameter: A required parameter is missing or failed validation. BadRequest: Generic 400 used when no more specific code fits. InvalidContentType: The `Content-Type` header is not `application/json`. ResourceNotFound: >- The referenced resource does not exist. Note: returned as HTTP 400, not 404 (historical choice). NoLicense: The feature is license-gated and no active license was found. ReferenceExist: Deletion blocked — other entities still reference this resource. Unauthorized: '`app_key` is missing, invalid, or expired.' BalanceNotEnough: Billing-gated operation with insufficient account balance. AccessDenied: Authenticated but lacking the permission required for this operation. RouteNotFound: The request URL path is not a known route. MethodNotAllowed: The HTTP method is not allowed on this otherwise-known path. UndonedOrderExist: An outstanding billing order blocks this new one. Wait and retry. RequestLocked: Operation temporarily locked due to repeated failures. EntityTooLarge: Request body exceeds the configured max size. RequestTooFrequently: Rate limit hit — API-global, per-account, or per-integration. RequestVerifyRequired: Second-factor verification required but not supplied. DangerousOperation: High-risk operation requires MFA verification. InternalError: Unhandled server-side error. Include `request_id` in the bug report. ServiceUnavailable: A backend dependency is unavailable. Try again later. example: InvalidParameter responses: BadRequest: description: Invalid request — usually a missing or malformed parameter. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missingParameter: value: request_id: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4 error: code: InvalidParameter message: The specified parameter is not valid. Unauthorized: description: Missing or invalid app_key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missingAppKey: value: request_id: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4 error: code: Unauthorized message: You are unauthorized. TooManyRequests: description: >- Rate limit hit. Either the global API limit, a per-account limit, or a per-integration limit. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: rateLimited: value: request_id: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4 error: code: RequestTooFrequently message: Request too frequently. ServerError: description: Unexpected server-side error. Include the request_id when reporting. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: internal: value: request_id: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4 error: code: InternalError message: >- We encountered an internal error, and it has been reported. Please try again later. securitySchemes: AppKeyAuth: type: apiKey in: query name: app_key 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. ````