flatpeak-api-spec-energy.json, carries them.
Device
| Field | Where | What it is |
|---|---|---|
hardware | Create, update, read | The physical unit: hardware_id (serial number or VIN), manufacturer, model_code, model_name. Required before the device can enroll |
capabilities.battery, inverter, evse, vehicle | Create, update, read | What the device can do, per subsystem: power, capacity, limits. They set eligibility, dispatch limits, supported settings and accepted state blocks. The Platform pages show only capabilities.pv |
capabilities.metering.location | Create, update, read | true when the device measures the location’s grid connection point |
vpp_enabled | Create, update, read | Whether Connect may offer the device VPP enrollment. Defaults to your account’s VPP switch |
consents | Read | The consent scopes each VPP operator holds for the device now. Consent history keeps every grant and revocation |
telemetry | Read | The feeds enrolled programs require, their sampling intervals, and their health |
response_time | Read | How quickly your integration fetches and confirms instructions for the device |
Location
| Field | Where | What it is |
|---|---|---|
grid_connection | Create, update, read | Import and export limits of the grid connection, in kW |
grid_reference | Create, update, read | A network reference such as an LV feeder, for locational programs |
metering | Read | Which device meters the grid connection point, and whether two devices claim to |
User
| Field | Where | What it is |
|---|---|---|
first_name, last_name, email_address, phone | Create, update, read | Personal details a VPP operator needs to register the user. Connect collects them on the personal details page when a program asks |
Connect session
| Field | Where | What it is |
|---|---|---|
operator_id | Create, update, read | Limits the VPP flow to one VPP operator’s programs |
device_telemetry_required | Read | true when the device’s enrolled programs require telemetry from it |

