v1

latestOpenAPI 3.0.32026-07-131670112.4 KB

Alerts

Fire an alert

Create a new alert. critical severity automatically creates an incident ticket with a 1h SLA and broadcasts to all SSE clients. All alerts trigger push + ntfy notifications if the user has a topic configured.

post/v1/alerts

Request body

titlestring required

bodystring

severity'info' | 'warning' | 'critical'

source_refstring

External reference (sensor ID, webhook ID, etc.)

org_idinteger nullable

latnumber nullable

lngnumber nullable

location_namestring nullable

metaobject nullable

Response

Default Response

object required

Example response

{
  "Id": 1,
  "title": "Pressure sensor offline",
  "body": "Sensor unit-7 at Site Alpha has not reported in 5 minutes.",
  "severity": "critical",
  "source": "sensor",
  "source_ref": "sensor-unit-7",
  "status": "firing",
  "user_id": 1,
  "org_id": 3,
  "ticket_id": null,
  "lat": 35.4676,
  "lng": -97.5164,
  "location_name": "Site Alpha",
  "meta": null,
  "fired_at": "2026-03-24T12:00:00Z",
  "acked_at": null,
  "resolved_at": null
}