Alerts
Alerts endpoints of the DynVolt Open API.
Plant alerts with status filtering, plus acknowledge and resolve actions.
GET /v1/sites/{site_id}/alerts
Alerts (?status= repeatable; default active,acknowledged).
Scope: alerts:read · Module: basic_scada
| Query parameter | Type | Required | Description |
|---|---|---|---|
status | string (repeatable) | no | Repeatable. One of active, acknowledged, resolved. Defaults to active + acknowledged. |
curl "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/alerts" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"POST /v1/sites/{site_id}/alerts/{alert_id}/acknowledge
Acknowledge an alert.
Scope: alerts:write · Module: basic_scada · Write (rate-limited at 30/min)
- Supports the
Idempotency-Keyheader for safe retries (24-hour replay). Returns409 conflict_safe_modewhile the site is in commissioning safe mode.
curl -X POST "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/alerts/900/acknowledge" \
-H "Authorization: Bearer $DYNVOLT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{ ... }'POST /v1/sites/{site_id}/alerts/{alert_id}/resolve
Resolve an alert.
Scope: alerts:write · Module: basic_scada · Write (rate-limited at 30/min)
- Supports the
Idempotency-Keyheader for safe retries (24-hour replay). Returns409 conflict_safe_modewhile the site is in commissioning safe mode.
curl -X POST "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/alerts/900/resolve" \
-H "Authorization: Bearer $DYNVOLT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{ ... }'
