connect_session.complete | A customer finishes a Connect session, whether or not the redirect to callback_url happens | Mark the session done. device.connect follows for each connected device; if none follows, the customer left without connecting |
device.connect | A customer connects a device | Retrieve the device and its enrollment. Check consent_scopes |
device.update | A device changes: its dispatch_limits when the OEM adds or removes hardware, or its consent_scopes when the customer grants or withdraws consent. It does not fire on telemetry | Retrieve the device and refresh your cached copy. For a consent change, read consent history |
vpp_enrollment.update | An enrollment changes state or step, including a customer’s request to leave | Retrieve the enrollment. At step AWAITING_APPROVAL or UNENROLLING, approve it. At other steps, read enrollment_state and the device’s telemetry to see if it is dispatchable |
program.update | A program changes status, for example during approval | Retrieve the program |
vpp_event.update | A VPP event changes status: allocation open, locked, active, complete or canceled | Retrieve the event and read delivery. List its devices for each device’s share and status. fulfillment is null until meter records cover the window |
device.instructions.confirm | The OEM confirms the power a device will deliver for your plan or its share of a VPP event. It fires once per device per confirmation, so a VPP event over a large group sends thousands. Subscribe only if you track confirmations per device | Read the timeline. A confirmed power below the instruction is a deviation, and the instruction stands. Confirmations show intent; meter records prove delivery |
device.settings.update | A device’s settings change, from either app or on the device | Retrieve the settings and update your UI |
device.settings.sync_failed | The device has not applied a settings change in the expected window | Re-fetch the settings. If your write was superseded or refused by hardware limits, show the customer the current values |
zone.membership.update | Devices join or leave a zone, or a new or changed zone finishes resolving | Retrieve the zone for its device_count, and list the zone’s devices |
export.complete | An export finishes and its download URL is ready | Retrieve the export |
reward.update | Flatpeak creates a reward entry or recalculates its amount. Your own approve and mark paid calls do not fire it | List rewards |
