> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# What VPP adds

> The fields VPP adds to users, locations, devices and Connect sessions.

The Platform pages show users, locations, devices and Connect sessions without their VPP fields. VPP adds the fields below to the same objects, endpoints and IDs. The full spec, `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](/docs/energy-api/reference/vpp-enrollments/consent-history.md) 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](/docs/energy-api/reference/connect/vpp/personal-details.md) 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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.