Skip to content
TriedDocs
Account

List alerts

List every alert rule in the workspace.

GEThttps://api.tried.com.au/alerts

Returns all alert rules in the workspace, oldest first, with their current state and last value.

Request#

This endpoint takes no path, query or body parameters.

Example request#

curl https://api.tried.com.au/alerts \
  -H "Authorization: Bearer $TRIED_API_KEY"
const res = await fetch("https://api.tried.com.au/alerts", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const alerts = await res.json();
import os, requests

res = requests.get(
    "https://api.tried.com.au/alerts",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
alerts = res.json()

Response#

200 OK

[
  {
    "alert_id": "alert_3f9a1c7e2b8d4a6f0e1c5b92",
    "name": "High p90 latency",
    "metric": "e2e_latency_p90",
    "threshold_type": "absolute",
    "comparator": ">",
    "threshold": 1500,
    "window_minutes": 60,
    "frequency_minutes": 5,
    "agent_ids": [
      "agent_4b7e2c9a1f3d5e8b0c6a2d1f"
    ],
    "emails": [
      "ops@example.com"
    ],
    "webhook_url": "https://example.com/hooks/alerts",
    "enabled": true,
    "state": "triggered",
    "last_value": 1720,
    "last_checked_timestamp": 1792398600000,
    "created_timestamp": 1792395000000
  }
]

The response is a JSON array of alert objects.

Field Type Description
alert_id string Alert ID, prefixed alert_.
state string ok or triggered. Changes only when the rule is evaluated (by the scheduler or Evaluate alert).
last_value number or null Value from the last evaluation. For a relative rule this is the percent change against the previous window. null until the first evaluation.
last_checked_timestamp integer or null Unix ms of the last evaluation.
created_timestamp integer Unix ms when the rule was created.

See Create alert for the settings fields.

Errors#

Status When
401 Missing or invalid API key.
403 The key's IP allowlist or scopes reject the request. This route needs the analytics scope.
429 Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Retell's public API reference has no alerting endpoints, so this route has no Retell SDK equivalent.