DynVoltDYNVOLT · developers

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 parameterTypeRequiredDescription
statusstring (repeatable)noRepeatable. 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-Key header for safe retries (24-hour replay). Returns 409 conflict_safe_mode while 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-Key header for safe retries (24-hour replay). Returns 409 conflict_safe_mode while 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 '{ ... }'