REST

Alerts

Returns alerts sorted by severity then recency. Supports filtering by site, severity, and status.

GET/api/v1/alerts

Active alerts across the portfolio

Returns alerts sorted by severity then recency. Defaults to status=active. Supports filtering by site, severity, or status.

Request

bash

curl -X GET \
  'https://letoseo.com/api/v1/alerts' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

Query parameters

Name	Type	Required	Description	Default
`site_id`	`uuid`	optional	Filter alerts to a specific site.	—
`severity`	`"critical" \| "warning" \| "info"`	optional	Filter by alert severity.	—
`status`	`"active" \| "acknowledged" \| "resolved"`	optional	Filter by alert lifecycle status.	`active`
`limit`	`integer`	optional	Maximum number of alerts to return.	—

Responses

200List of alerts enriched with site name.

json

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000030",
      "user_id": "00000000-0000-0000-0000-000000000099",
      "site_id": "00000000-0000-0000-0000-000000000001",
      "site_name": "Acme Demo Co",
      "type": "traffic_drop",
      "severity": "critical",
      "status": "active",
      "message": "Organic sessions dropped 54% vs 7-day average",
      "metric_value": 46,
      "threshold_value": 50,
      "created_at": "2025-01-14T06:45:00.000Z",
      "acknowledged_at": null,
      "resolved_at": null
    }
  ],
  "_meta": {
    "generated_at": "2025-01-15T10:30:00.000Z"
  }
}