Skip to main content
POST
/
v1
/
alert-rules
Create an alert rule
curl --request POST \
  --url https://api.us.poly.ai/v1/alert-rules \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "High turn latency (p95)",
  "project_id": "proj_abc123",
  "metric": "turn_latency_p95",
  "operator": ">=",
  "threshold_value": 1500,
  "window_duration": "5m",
  "enabled": true
}
'
{
  "id": "ar_0Kx4mNpQ8rWvYb2dFgHjLs",
  "name": "<string>",
  "metric": "turn_latency_p50",
  "operator": ">",
  "threshold_value": 1,
  "window_duration": "5m",
  "enabled": true,
  "current_state": "ok",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "project_id": "<string>",
  "since": "2023-11-07T05:31:56Z",
  "last_evaluated_at": "2023-11-07T05:31:56Z",
  "current_value": 123
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
name
string
required
​
metric
enum<string>
required
Available options:
turn_latency_p50,
turn_latency_p95,
api_errors,
function_errors,
call_crashes,
call_volume
​
operator
enum<string>
required
Available options:
>,
<,
>=,
<=
​
threshold_value
integer
required
Required range: x >= 0
​
window_duration
enum<string>
required

Evaluation window duration

Available options:
5m,
10m,
60m
​
project_id
string | null
​
enabled
boolean
default:true

Response

Alert rule created successfully.

​
id
string
required
Pattern: ^ar_[A-Za-z0-9]+$
Example:

"ar_0Kx4mNpQ8rWvYb2dFgHjLs"

​
name
string
required
​
metric
enum<string>
required
Available options:
turn_latency_p50,
turn_latency_p95,
api_errors,
function_errors,
call_crashes,
call_volume
​
operator
enum<string>
required
Available options:
>,
<,
>=,
<=
​
threshold_value
integer
required
Required range: x >= 0
​
window_duration
enum<string>
required

Evaluation window duration

Available options:
5m,
10m,
60m
​
enabled
boolean
default:true
required
​
current_state
enum<string>
required
Available options:
ok,
alert,
no_data,
unknown
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
project_id
string | null
​
since
string<date-time> | null
​
last_evaluated_at
string<date-time> | null
​
current_value
integer | null
Last modified on March 31, 2026