---
title: "Get an alert rule"
method: GET
path: "/v1/alert-rules/{rule_id}"
---

# Get an alert rule

`GET /v1/alert-rules/{rule_id}`

Get a single alert rule by its ID.

## Path parameters

- `rule_id` string, required

## Response `200`

Alert rule retrieved successfully.

- AlertRuleResponse — An alert rule: its trigger condition, evaluation window, and current state.
  - `id` string, required — Alert rule ID
  - `name` string, required — Alert rule name
  - `project_id` string, nullable — Project ID
  - `metric` 'turn_latency_p50' | 'turn_latency_p95' | 'api_errors' | 'function_errors' | 'call_crashes' | 'call_volume', required — Metric to monitor.
  - `operator` '>' | '<' | '>=' | '<=', required — Comparison operator used by the alert rule.
  - `threshold_value` integer, required — Threshold value
  - `window_duration` '5m' | '10m' | '60m', required — Evaluation window duration. Allowed values: `5m`, `10m`, or `60m`.
  - `enabled` boolean, required — Whether the alert is enabled
  - `current_state` 'ok' | 'alert' | 'no_data' | 'unknown' — Current state of an alert rule.
  - `since` string, date-time, nullable — When the current state started
  - `last_evaluated_at` string, date-time, nullable — Last evaluation timestamp
  - `current_value` integer, nullable — Current metric value
  - `created_at` string, date-time, required — Creation timestamp
  - `updated_at` string, date-time, required — Last update timestamp

## Other responses

- `401` — Missing or invalid API key.
- `404` — Resource not found.
- `422` — Validation error or malformed resource ID.
- `500` — Internal server error.

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/versions/76f3c606e395/schema)