Alert Rules

Configure threshold-based alert rules and composite rules that combine multiple conditions.

Create an alert rule

POST /alert-rules

Auth: Bearer JWT (admin)

curl -X POST https://api.haltless.io/api/v1/alert-rules \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "machine_id": "MACHINE_UUID",
    "metric_name": "temperature",
    "operator": ">",
    "threshold": 85.0,
    "severity": "critical",
    "name": "High temperature alert"
  }'

Request body:

Field	Type	Required	Description
machine_id	uuid	Yes	Target machine
metric_name	string	Yes	Metric to monitor
operator	string	Yes	>, >=, <, <=, ==
threshold	number	Yes	Threshold value
severity	string	Yes	info, warning, critical
name	string	No	Human-readable name

List alert rules

GET /alert-rules

Auth: Bearer JWT (any role)

Parameter	Type	Description
machine_id	uuid	Filter by machine

Update an alert rule

PUT /alert-rules/{rule_id}

Auth: Bearer JWT (admin)

Delete an alert rule

DELETE /alert-rules/{rule_id}

Auth: Bearer JWT (admin)

AI-suggested rules

GET /alert-rules/suggestions

Auth: Bearer JWT (any role)

Uses AI to analyze your sensor data patterns and suggest appropriate alert thresholds.

Parameter	Type	Default
language	string	en

Composite alert rules

Combine multiple conditions with AND/OR logic.

Create a composite rule

POST /composite-rules

Auth: Bearer JWT (admin)

{
  "machine_id": "MACHINE_UUID",
  "name": "High temp AND vibration",
  "operator": "AND",
  "severity": "critical",
  "conditions": [
    {"metric_name": "temperature", "operator": ">", "threshold": 80.0},
    {"metric_name": "vibration", "operator": ">", "threshold": 7.0}
  ]
}

Operators: AND (all conditions must be true), OR (any condition triggers)

List composite rules

GET /composite-rules

Update a composite rule

PUT /composite-rules/{rule_id}

Delete a composite rule

DELETE /composite-rules/{rule_id}