Device Connection Events

Device connection events are used to notify clients when a device comes online or goes offline.

device.connection.online

Sent when a device comes online.

{
  "type": "event",
  "topic": "device.connection.online",
  "data": {
    "deviceId": "abc123456789",
    "occurredAt": "2026-04-03T00:41:44Z"
  }
}

device.connection.offline

Sent when a device goes offline.

{
  "type": "event",
  "topic": "device.connection.offline",
  "data": {
    "deviceId": "abc123456789",
    "occurredAt": "2026-04-03T00:41:46Z"
  }
}

data Schema

Field	Type	Required	Description
deviceId	string	Yes	Unique device identifier
occurredAt	string	Yes	Event time in RFC3339 UTC

Client Handling

• An online event does not mean all device state has already been synchronized
• After an offline event, the client should no longer assume the device can still be controlled
• To confirm current state, call REST Get Device