Operations

Alerts.

Define threshold rules, receive alert events and acknowledge them with an operator note.

Alert rules

GET/v1/alert-rules

List rules

Returns all alert rules in your tenant.

Required scopesalerts.read

POST/v1/alert-rules

Create a rule

Trigger on a metric exceeding a threshold for a minimum duration.

Required scopesalerts.write

Request

POST /v1/alert-rules
{
  "name": "Gearbox overheating",
  "scope": { "windFarmId": "wf_borssele_iii_iv" },
  "metric": "gearboxTemperature",
  "operator": ">",
  "threshold": 78,
  "durationSeconds": 300,
  "severity": "warning"
}

Response

{ "id": "ar_9f12...", "isActive": true }

Alert events

GET/v1/alerts

List alerts

Filter by status, severity, turbine or time window.

Required scopesalerts.read

Request

GET /v1/alerts?status=open&severity=warning,critical

Response

{
  "data": [
    {
      "id": "al_1234",
      "ruleId": "ar_9f12",
      "turbineId": "wt_b3_a07",
      "metric": "gearboxTemperature",
      "value": 82.4,
      "openedAt": "2025-05-16T08:21:00Z",
      "status": "open",
      "severity": "warning"
    }
  ]
}

POST/v1/alerts/{id}/acknowledge

Acknowledge an alert

Marks the alert as acknowledged with an operator note.

Required scopesalerts.write

Request

POST /v1/alerts/al_1234/acknowledge
{ "note": "Service team dispatched." }