Configure a Tesla Fleet API energy endpoint integration to aggregate residential Powerwall fleet state and receive availability signals for VPP dispatch

Steps

1. Register a third-party application on the Tesla Developer Portal and obtain OAuth 2.0 client credentials; implement the Tesla Fleet API OAuth flow using the authorization_code grant type with scope energy:read energy:write
2. After user authorization, call GET https://fleet-api.prd.na.vn.cloud.tesla.com/api/1/energy_sites/{energy_site_id}/live_status to retrieve real-time Powerwall data: battery_power (W), energy_left (Wh), percentage_charged, island_status, and backup_reserve_percent
3. To set the operating mode for VPP dispatch, PUT to /api/1/energy_sites/{energy_site_id}/operation with body {default_real_mode: 'self_consumption'} or {default_real_mode: 'backup'} depending on the dispatch signal; confirm 200 OK and read back the updated mode
4. Subscribe to fleet-level telemetry by polling each site's /live_status endpoint at 5-minute intervals; aggregate battery_power across all enrolled sites to compute total fleet kW available for dispatch
5. For time-of-use (TOU) optimization mode, POST to /api/1/energy_sites/{energy_site_id}/tariff_rate with the utility tariff schedule JSON; Tesla will automatically discharge during peak periods per the tariff
6. Validate that each enrolled Powerwall has a valid VPP enrollment status by checking the programs field in the /live_status response before including the site in a dispatch commitment