Defects
Defects endpoints of the DynVolt Open API.
O&M defect log: list, create, and update. Writes support idempotency keys.
GET /v1/sites/{site_id}/defects
O&M defects (?location_id&logger_id&status&severity&offset&limit).
Scope: om:read · Module: om
| Query parameter | Type | Required | Description |
|---|---|---|---|
status | string | no | Filter by defect status. |
severity | string | no | Filter by severity. |
location_id | integer | no | Filter by location. |
logger_id | integer | no | Restrict to a single logger (plant). Omit for all plants. |
offset | integer | no | Rows to skip (pagination). |
limit | integer | no | Maximum rows to return (capped at 200). |
curl "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/defects" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"POST /v1/sites/{site_id}/defects
Log a defect.
Scope: om:write · Module: om · 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/defects" \
-H "Authorization: Bearer $DYNVOLT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{ ... }'GET /v1/sites/{site_id}/defects/{defect_id}
One defect.
Scope: om:read · Module: om
curl "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/defects/55" \
-H "Authorization: Bearer $DYNVOLT_API_KEY"PUT /v1/sites/{site_id}/defects/{defect_id}
Update a defect.
Scope: om:write · Module: om · 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 PUT "https://api.owner.dynvolt.com/v1/sites/pv-ljubas/defects/55" \
-H "Authorization: Bearer $DYNVOLT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{ ... }'