Changelog

2026-08-11 — Full owner surface

The API now mirrors the full owner surface — 108 operations across 102 paths.

New read areas: weather / EMI stations, efficiency & diagnostics rankings, I-V curve analysis, curtailment status, markets & cross-market comparison, and the complete BESS telemetry set (clusters, PCS, envelope, protection, alarms, dispatch/control logs, schedules).
Control writes (new): curtailment — schedule a window, curtail immediately, release a group (curtailment:write); and BESS dispatch approval — optimize, approve/reject, approve-all, edit-hour (bess:write). Both are control scopes. Curtailment can only ever reduce output; no write can raise a plant above its grid-connection permit.
Scopes: expanded to 17 — the eight basic_scada reads (plant, weather, diagnostics, energy, curtailment, markets, alerts, reports) plus earnings, predictions, bess, om, and the five write scopes. See Scopes & modules.
New guides: Scopes & modules, Curtailment, BESS.
Not exposed by design: grid-permit settings, panel-model edits, and raw BESS hardware control (power/breaker/grid-mode/fault-reset).

Initial public release of the DynVolt Open API.

Base URL https://api.owner.dynvolt.com, all endpoints under /v1.
32 endpoints across sites, live plant telemetry (overview, plant, loggers, inverters, strings, sensors, weather, gaps, rankings), energy, alerts, markets, earnings, predictions, BESS, O&M work orders & defects, and reports.
API keys (dvk_live_...) created self-service in the owner platform, with per-token scopes mapped to module entitlements.
Writes limited to O&M workflows: work orders (create/update/approve), defects (create/update), alert acknowledge/resolve, and report subscription runs — all with optional Idempotency-Key support (24-hour replay window).
Rate limits: 120 requests/min and 5,000/day per token (writes 30/min), with X-RateLimit-* headers on every response and Retry-After on 429.
Consistent envelopes: {"data": [...], "meta": {...}} for lists, {"error": {...}} for errors, X-Request-Id on every response.

No plant-control endpoints are exposed — curtailment and BESS control remain exclusive to the owner platform.