> ## Documentation Index > Fetch the complete documentation index at: https://docs.fiddler.ai/llms.txt > Use this file to discover all available pages before exploring further. # Returns Alert Rule for the given id > Returns Alert Rule for the given id ## OpenAPI ````yaml GET /v3/alert-rules/{alert_id} openapi: 3.0.3 info: title: Fiddler API - 2.0 description: APIs to interact with Fiddler termsOfService: https://fiddler.ai/about/terms contact: email: support@fiddler.ai license: name: Proprietary url: '2.0' version: '2.0' servers: [] security: - BearerAuth: [] tags: - name: access-key description: CRUD operations for API keys - name: span-v3 - name: aggregation-invalidation-request-v3 description: Endpoints related to retrieving aggregation invalidation requests - name: alert-rules-v3 description: CRUD for Alert Rules, Summary, and Stats APIs - name: application-v3 - name: auth description: Authentication strategies and login flows - name: baseline-v3 description: CRUD for baseline - name: catalog-v3 description: >- Entity catalog provides paginated, searchable discovery of entity names (attribute keys, agent names, span types, span names, score names, evaluator config names) and their distinct values. Powered by ClickHouse materialized views — no worker or PostgreSQL dependency. - name: chart-annotation-v3 description: Endpoints related to retrieving chart annotations - name: chart-v3 description: CRUD for chart - name: queries-v3 description: v3 queries API - name: configuration-v3 description: CRUD for configurations - name: cost-evaluators-v3 description: > Paginated roll-up of per-evaluator LLM cost and token usage, aggregated hourly. Available only on deployments with evaluator cost reporting enabled. - name: custom-metrics-v3 - name: dimensionality-reduction-v3 - name: environment-v3 description: Endpoints related to environment management - name: evals - name: datasets - name: evaluation-v3 - name: evaluator-v3 - name: rule-evaluators-v3 - name: experiment-v3 - name: explainability-v3 - name: llm_rca-v3 - name: file-upload description: Endpoints related to file uploading. - name: fql-expressions-v3 description: > Endpoints for listing FQL (Fiddler Query Language) functions available for GenAI custom metrics. Used by the frontend for autocomplete and signature hints in the FQL editor. - name: genai-alert-rules-v3 description: CRUD API for GenAI Alert Rules - name: genai-custom-metrics-v3 description: API for GenAI Custom Metrics - name: genai-metrics-v3 description: >- Endpoints for pre-aggregated GenAI metrics. All metric data is pre-aggregated hourly by a Celery-based metric collector; no real-time aggregation is performed at request time. - name: guardrails-api description: Endpoints related to retrieving Guardrails specific data - name: ingestion-v3 - name: intercom-api description: Endpoints related to intercom APIs - name: jobs-v3 - name: llm-gateway-v3 - name: auth-login - name: auth-logout - name: mcp-client-setup-v3 description: Endpoints for retrieving MCP client setup instructions. - name: metrics-v3 description: Metrics endpoints - name: model-v3 - name: dashboard-v3 - name: model-deployment-v3 - name: monitoring-summary-v3 - name: histograms-v3 - name: organization-roles-v3 description: Update user org role - name: organization-settings-v3 description: Update organization settings such as timezone, email configuration, etc. - name: pagerduty-api description: CRUD for Pagerduty services. - name: project-v3 - name: project-roles-v3 description: Project role assignment management - name: scores-v3 description: Unified CRUD for scores and annotations - name: searchable-text-key-v3 description: >- Manage the global searchable text keys table that controls which OTel attribute keys are routed to the full-text-searchable `ValueContent` column in the unified attributes table. Changes propagate to the backing ClickHouse dictionary within 1-2 minutes and affect all tenants. - name: segments-v3 - name: semantic-mapping-v3 description: >- Manage the global semantic name mappings table that maps raw OTel attribute keys to canonical semantic concepts. Changes propagate to the backing ClickHouse dictionary within 1-2 minutes and affect all tenants. - name: server-info-v3 description: Endpoints related to retrieving server information - name: service-account description: > Service accounts and their API keys. A human Org Admin manages the service accounts of their own organization: create, read, update, and enable/disable (there is no delete — an account is disabled instead), and issue, rename, re-date, enable/disable, and revoke each account's API keys. An API key is an `fks_` secret that inherits the account's grants and cannot manage service accounts; an active, unexpired key must be disabled before it can be revoked, and it authenticates only while both it and its account are active. Scopes here are capability scopes (what the account may do), not OAuth scopes. - name: sessions-v3 description: v3 session APIs - name: team-roles-v3 - name: team-v3 - name: traces-v3 description: v3 trace api for monitoring - name: fetch-sessions-v3 description: v3 fetch sessions api for monitoring - name: user-access-key description: > CRUD operations for user API keys. All endpoints are user-scoped — each user can only operate on their own API keys. No one including Org admins have access to other users' API keys. - name: users-v3 - name: version-compatibility-v3 - name: webhooks externalDocs: url: https://docs.fiddler.ai description: Find out more about Fiddler paths: /v3/alert-rules/{alert_id}: get: tags: - alert-rules-v3 summary: Returns Alert Rule for the given id description: Returns Alert Rule for the given id operationId: getAlertRule parameters: - $ref: '#/components/parameters/alert_id' responses: '200': description: Alert Rule details content: application/json: schema: allOf: - $ref: '#/components/schemas/ApiResponse' - type: object properties: data: $ref: '#/components/schemas/AlertRule' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '404': $ref: '#/components/responses/404' '500': $ref: '#/components/responses/500' components: parameters: alert_id: name: alert_id in: path description: alert id path parameter required: true schema: type: string format: uuid schemas: ApiResponse: type: object description: | Response object for standard API responses. properties: api_version: type: string default: '3.0' enum: - '2.0' - '3.0' description: | API version. kind: type: string default: NORMAL enum: - NORMAL description: | Type of response, indicating a normal response. AlertRule: type: object required: - id - name - organization - project - model - priority - metric - compare_to - condition - threshold_type - baseline - created_at - updated_at - created_by - updated_by - bin_size - evaluation_delay properties: id: type: string format: uuid description: Unique identifier for the Alert Rule. is_fiddler_generated: type: boolean description: Boolean indicating whether the Alert Rule is generated by Fiddler. created_at: type: string format: date-time description: Timestamp indicating when the Alert Rule was created. updated_at: type: string format: date-time description: Timestamp indicating when the Alert Rule was last updated. name: type: string description: Name of the Alert Rule. organization: $ref: '#/components/schemas/OrganizationCompact' metric: $ref: '#/components/schemas/MetricCompact' feature_names: nullable: true type: array items: type: string description: List of feature names for which we have created an Alert Rule. priority: $ref: '#/components/schemas/PriorityEnum' compare_to: $ref: '#/components/schemas/CompareToEnum' condition: $ref: '#/components/schemas/ConditionEnum' compare_bin_delta: type: integer description: >- This field specifies the lookback period for relative comparisons, expressed as a multiple of the chosen time bin size. It determines the historical data timeframe used to evaluate changes in the metric value. evaluation_delay: type: integer description: >- It indroduces the delay in the evaluation of Alert Rule. It is in multiple of hours, and max could be one year. category: nullable: true type: string description: >- Setting Frequency Alerts on categorical columns requires specifying a category. For example, if the column represents geographical locations such as France, Germany, and India, you would pass 'France' as the category and 'geography' as the feature name to set a frequency alert. bin_size: $ref: '#/components/schemas/BinSizeEnum' threshold_type: $ref: '#/components/schemas/ThresholdAlgoEnum' auto_threshold_params: nullable: true allOf: - $ref: '#/components/schemas/StandardDeviationAlgorithmParams' warning_threshold: nullable: true type: number format: double description: Threshold value for triggering a warning alert. critical_threshold: nullable: true type: number format: double description: Threshold value for triggering a critical alert. enable_notification: type: boolean description: Indicates whether notifications are enabled for the Alert Rule. model: $ref: '#/components/schemas/ModelCompact' project: $ref: '#/components/schemas/ProjectCompact' baseline: nullable: true allOf: - $ref: '#/components/schemas/BaselineCompact' segment: nullable: true allOf: - $ref: '#/components/schemas/SegmentCompact' created_by: $ref: '#/components/schemas/UserCompact' updated_by: $ref: '#/components/schemas/UserCompact' OrganizationCompact: type: object title: OrganizationCompact description: > Compact version of an organization which can be included in the response of relevant APIs. required: - id - name properties: id: type: string format: uuid description: | Unique identifier of the organization. name: type: string description: | Name of the organization. MetricCompact: type: object title: MetricCompact required: - id - type - display_name - type_display_name properties: id: type: string description: Name for builtin metrics, UUID for custom metrics display_name: type: string type: $ref: '#/components/schemas/MetricTypeEnum' type_display_name: $ref: '#/components/schemas/MetricTypeDisplayNameEnum' PriorityEnum: type: string enum: - HIGH - MEDIUM - LOW CompareToEnum: type: string description: >- This API provides two alert evaluation methods, absolute comparisons determine if the current metric value breaches a predefined threshold, while relative comparisons analyze changes in metric by referencing a chosen time period. enum: - raw_value - time_period ConditionEnum: type: string description: The comparison condition while evaluating the Alert Rule. enum: - lesser - greater BinSizeEnum: type: string description: The Supported bin sizes for the Alert Rules. enum: - Hour - Day - Week - Month ThresholdAlgoEnum: type: string description: The type of threshold algorithm used to evaluate alerts. enum: - manual - standard_deviation_auto_threshold StandardDeviationAlgorithmParams: type: object description: >- Auto threshold parameters for the Alert Rule. These parameters are used to tweak the calculations of the thresholds. required: - warning_multiplier - critical_multiplier properties: warning_multiplier: type: number format: float critical_multiplier: type: number format: float ModelCompact: type: object title: ModelCompact description: > Compact version of a model which can be included in the response of relevant APIs. required: - id - name - version properties: id: type: string format: uuid description: | Unique identifier for the model. name: type: string description: | Name of the model. version: type: string description: | Version of the model. ProjectCompact: type: object title: ProjectCompact description: > Compact version of a project which can be included in the response of relevant APIs. required: - id - name properties: id: type: string format: uuid description: | Unique identifier of the project. name: type: string description: | Name of the project. asset_type: type: string enum: - ML_MODEL - GEN_AI_APP description: | Type of assets the project can have. BaselineCompact: type: object title: BaselineCompact description: > Compact version of a baseline which can be included in the response of relevant APIs. required: - id - name properties: id: type: string format: uuid description: | Unique identifier of the baseline. name: type: string description: | Name of the baseline. SegmentCompact: type: object title: SegmentCompact description: Compact version of segment for v3 properties: id: type: string format: uuid description: Unique identifier of the saved segment definition: type: string description: FQL definition of the applied segment UserCompact: type: object title: UserCompactV3 description: > Compact version of a user which can be included in the response of relevant APIs. required: - id - email properties: id: type: string format: uuid readOnly: true description: | Unique identifier for the user. full_name: type: string readOnly: true description: | Full name of the user. email: type: string format: email description: | Email address of the user. ErrorResponse: type: object description: | Response object for errors returned by the API. properties: api_version: type: string default: '3.0' enum: - '2.0' - '3.0' description: | API version of the response. kind: type: string default: ERROR enum: - ERROR description: | Type of response, usually indicating an error. error: type: object properties: code: type: integer format: int32 description: > Represents the code for this error, typically an HTTP response code. default: 400 enum: - 400 - 401 - 403 - 404 - 409 - 410 - 422 - 429 - 500 - 501 - 503 message: type: string description: > A human-readable message providing more details about the error. If there are multiple errors, it will be the message for the first error. example: Resource Not Found errors: type: array description: > Container for additional information regarding the error, especially for multiple errors. items: type: object properties: reason: type: string description: > Unique identifier for this error, different from the error code. example: ResourceNotFoundException message: type: string description: > A human-readable message providing more details about the error. If there is only one error, this field will match error.message. example: Resource Not Found help: type: string description: > Link to support or documentation providing more information on the error. MetricTypeEnum: type: string enum: - drift - data_integrity - performance - service_metrics - statistic - custom MetricTypeDisplayNameEnum: type: string enum: - Data Drift - Data Integrity - Performance - Traffic - Statistic - Custom Metric responses: '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: BearerAuth: type: http scheme: bearer ````