> ## 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. # 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: 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/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: content: application/json: example: application_id: WoyQQ3BohkdtPivubEvE8o limit: 20 p: 0 schema: $ref: '#/components/schemas/RumPresetSeverityRuleHistoryListRequest' required: true responses: '200': content: application/json: example: data: has_next_page: false items: - rules: - account_id: 3790925372131 application_id: WoyQQ3BohkdtPivubEvE8o created_at: 1785744052160 created_by: 3790925372131 deleted_at: 0 description: Downgrade known extension errors to Info filters: - - key: error.error_message oper: IN vals: - >- /^ResizeObserver loop.*|.*chrome-extension:\/\/.*/ id: 4820 priority: 1 rule_id: n8mZQ2VbXk4wPRs6DfC9Ay rule_name: Known noisy browser extension errors severity: Info status: enabled updated_at: 1785744052160 updated_by: 3790925372131 - account_id: 3790925372131 application_id: WoyQQ3BohkdtPivubEvE8o created_at: 1785830452160 created_by: 3790925372131 deleted_at: 0 description: Escalate production crashes to Critical severity filters: - - key: error.env oper: IN vals: - production - key: error.is_crash oper: IN vals: - 'true' id: 4821 priority: 2 rule_id: TAHUYnQmXKzgMS4TFVUKvz rule_name: Critical crash spikes severity: Critical status: enabled updated_at: 1785830452160 updated_by: 3790925372131 updated_at: 1785916852160 updated_by: 2476444212131 updated_by_name: Alice Chen version: 3 - rules: - account_id: 3790925372131 application_id: WoyQQ3BohkdtPivubEvE8o created_at: 1785744052160 created_by: 3790925372131 deleted_at: 0 description: Downgrade known extension errors to Info filters: - - key: error.error_message oper: IN vals: - >- /^ResizeObserver loop.*|.*chrome-extension:\/\/.*/ id: 4820 priority: 1 rule_id: n8mZQ2VbXk4wPRs6DfC9Ay rule_name: Known noisy browser extension errors severity: Info status: enabled updated_at: 1785744052160 updated_by: 3790925372131 updated_at: 1785830452160 updated_by: 3790925372131 updated_by_name: Bob Zhang version: 2 - rules: [] updated_at: 1785744052160 updated_by: 3790925372131 updated_by_name: Bob Zhang version: 1 total: 3 request_id: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4 schema: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - properties: data: $ref: >- #/components/schemas/RumPresetSeverityRuleHistoryListResponse type: object description: Success '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' components: schemas: RumPresetSeverityRuleHistoryListRequest: description: Filters for listing preset severity rule change history. properties: application_id: description: >- RUM application ID. Get application IDs via `POST /rum/application/list`. type: string asc: default: false description: Sort ascending when true; results are descending by default. type: boolean limit: default: 20 description: >- Page size. Values <= 0 default to 20; values above 100 are capped at 100. maximum: 100 type: integer orderby: default: updated_at description: >- Sort column. Any other value (including omitted) falls back to `updated_at`. enum: - updated_at - version type: string p: default: 0 description: Zero-based page number. minimum: 0 type: integer required: - application_id type: object SuccessEnvelope: 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: data: description: Endpoint-specific payload. See each operation's 200 response schema. request_id: description: >- Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues. example: 01HK8XQE3Z7JM2NTFQ5YJ8P9R4 type: string required: - request_id - data type: object RumPresetSeverityRuleHistoryListResponse: description: Paginated list of preset severity rule history snapshots. properties: has_next_page: description: Whether another page is available after this one. type: boolean items: description: Preset severity rule history snapshots of the current page. items: $ref: '#/components/schemas/RumPresetSeverityRuleHistoryItem' type: array total: description: Total number of history snapshots for the application. format: int64 type: integer required: - total - has_next_page - items type: object RumPresetSeverityRuleHistoryItem: description: >- A versioned, application-level snapshot of all preset severity rules at the time of a change. properties: rules: description: >- Full rule set captured immediately before the mutation that produced this snapshot. Empty for the very first snapshot. items: $ref: '#/components/schemas/RumPresetSeverityRuleHistorySnapshotRule' type: array updated_at: description: Unix timestamp in milliseconds when the snapshot was written. format: int64 type: integer updated_by: description: Member ID who triggered the mutation this snapshot precedes. format: int64 type: integer updated_by_name: description: Display name of `updated_by` at the time of the change. type: string version: description: Monotonically increasing snapshot version number, starting at 1. type: integer required: - rules - version - updated_by - updated_by_name - updated_at 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 RumPresetSeverityRuleHistorySnapshotRule: 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. properties: account_id: description: Account ID the rule belongs to. format: int64 type: integer application_id: description: RUM application ID the rule belongs to. type: string created_at: description: Unix timestamp in milliseconds when the rule was created. format: int64 type: integer created_by: description: Member ID who originally created the rule. format: int64 type: integer deleted_at: 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. format: int64 type: integer description: description: Rule description. May be empty. type: string filters: 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: items: $ref: '#/components/schemas/RumPresetSeverityRuleFilterCondition' type: array type: array id: description: >- Internal auto-increment row ID. Not stable across a history revert — reverting reinserts rows with new IDs. format: int64 type: integer priority: description: Evaluation order at snapshot time; `1` is highest precedence. type: integer rule_id: description: Unique rule ID. type: string rule_name: description: Rule display name. type: string severity: description: Severity assigned to errors matching this rule. enum: - Critical - Warning - Info type: string status: description: Rule status at snapshot time. enum: - enabled - disabled type: string updated_at: description: Unix timestamp in milliseconds when the rule was last updated. format: int64 type: integer updated_by: description: Member ID who last updated the rule as of snapshot time. format: int64 type: integer 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 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 RumPresetSeverityRuleFilterCondition: description: One filter condition within an AND group. properties: key: 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) | 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 type: string oper: 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). enum: - IN - NOTIN type: string vals: 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.). items: type: string minItems: 1 type: array required: - key - oper - vals 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 ````