SystemLogNetworkChanged

Reported when a device's network interfaces change.

Payload

Field	Type	Required	Description
owner	object	✅	Ownership envelope identifying the company or organization that owns this event.
owner.ownershipType	"organization" (literal)	✅	Discriminator for the ownership envelope; always organization for these events.
owner.organizationUid	string	✅	UID of the organization that owns the event.
owner.parentCompanyUid	string	✅	UID of the owning organization's parent company.
type	"Device.SystemLog.NetworkChanged" (literal)	✅	Fully-qualified event type discriminator (e.g. Device.DeviceConnectionAdded).
deviceIdentityHash	string	✅	Server-generated unique identifier of the device, used as the public-facing identifier in the REST API.
receivedAt	string (date-time)	✅	When the platform received the system log.
recordedAt	string (date-time)	—	When the device recorded the system log; present for logs uploaded offline.
source	"online" | "offline" (literal)	✅	Whether the log arrived over the live device socket or via an offline upload.
data	object[]	✅

Example

{
  "id": "string",
  "kind": "systemLog",
  "type": "Device.SystemLog.NetworkChanged",
  "payload": {
    "owner": {
      "ownershipType": "organization",
      "organizationUid": "bc474008xxxxxxxxxxxxxxxx23411437",
      "parentCompanyUid": "266c0be7xxxxxxxxxxxxxxxxb5e5d14c"
    },
    "type": "Device.SystemLog.NetworkChanged",
    "deviceIdentityHash": "b4b54b94xxxxxxxxxxxxxxxx46aa591b",
    "receivedAt": "string",
    "recordedAt": "string",
    "source": "online",
    "data": [
      "string"
    ]
  }
}

Shape

{
  "id": "string",
  "kind": "systemLog",
  "type": "Device.SystemLog.NetworkChanged",
  "payload": {
    "owner": {
      "ownershipType": "organization",
      "organizationUid": "string",
      "parentCompanyUid": "string"
    },
    "type": "Device.SystemLog.NetworkChanged",
    "deviceIdentityHash": "string",
    "receivedAt": "string (date-time)",
    "recordedAt?": "string (date-time)",
    "source": "online | offline",
    "data": [
      {
        "anyOf": [
          {
            "type": "wifi",
            "name": "string",
            "macAddress": "string",
            "disabled?": "boolean",
            "gateway?": "string",
            "localAddress?": "string",
            "netmask?": "string",
            "dns?": [
              "string"
            ],
            "wifiStrength?": "number",
            "wifiSsid?": "string"
          },
          {
            "type": "ethernet",
            "name": "string",
            "macAddress": "string",
            "disabled?": "boolean",
            "gateway?": "string",
            "localAddress?": "string",
            "netmask?": "string",
            "dns?": [
              "string"
            ]
          },
          {
            "type": "vpn",
            "name": "string",
            "macAddress": "string",
            "disabled?": "boolean",
            "gateway?": "string",
            "localAddress?": "string",
            "netmask?": "string",
            "dns?": [
              "string"
            ]
          },
          {
            "type": "mobile",
            "name": "string",
            "macAddress": "string",
            "disabled?": "boolean",
            "gateway?": "string",
            "localAddress?": "string",
            "netmask?": "string",
            "dns?": [
              "string"
            ]
          }
        ]
      }
    ]
  }
}