Use the Uplight (AutoGrid Flex) VPP API to configure a demand flexibility event for a residential HVAC fleet and track real-time dispatch compliance

Steps

1. Authenticate via OAuth 2.0 client credentials to the Uplight platform API; request scope vpp:events:write vpp:telemetry:read to obtain a bearer token
2. Create a demand flexibility program event: POST to /api/v1/flexibility/events with payload containing program_id, event_type (SHED or SHIFT), start_time (ISO 8601 UTC), duration_minutes, target_reduction_kw, and device_filter (e.g., device_type: smart_thermostat)
3. Poll GET /api/v1/flexibility/events/{event_id}/enrollment to see which enrolled devices have been selected for dispatch and their pre-dispatch baseline temperatures and setpoints
4. Monitor real-time compliance during the event window: GET /api/v1/flexibility/events/{event_id}/realtime with a 60-second polling interval; the response includes per-device current_setpoint, baseline_setpoint, power_kw, and compliance_status (COMPLIANT / NON_COMPLIANT)
5. For non-compliant devices (customer override or communication failure), log the device_id and non_compliance_reason; non-compliant devices are excluded from the event's MW achievement calculation
6. After event completion, retrieve the final settlement report from GET /api/v1/flexibility/events/{event_id}/settlement to obtain total_kw_reduced, number_of_devices_dispatched, and performance_percentage for submission to the utility or RTO