Knox Webhook Notification 23.12 release notes

Last updated March 6th, 2024

The Knox Webhook Notification API currently provides the following APIs:

API	Description
`POST /kwn/v1/subscriptions`	Creates a subscription. Requires: The subscription URL or "callback". A set of Knox cloud services events. For example, the Knox Guard device enrollment event.
`GET/kwn/v1/subscriptions`	Retrieves the subscription associated with a customer.
`GET /kwn/v1/subscriptions/{subscriptionId}`	Retrieves the subscription associated with a particular subscriptionId. Used to identify the URL that Knox Webhook Notification uses to dispatch change notifications.
`PUT /kwn/v1/subscriptions/{subscriptionId}`	Updates an existing subscription associated with a particular subscriptionId.
`DELETE /kwn/v1/subscriptions/{subscriptionId}`	Deletes an existing subscription associated with a particular subscriptionId.

Starting with this release, the Knox Webhook Notification API supports subscription calls to the following Knox cloud service events:

Knox cloud service	Event	Description
Knox Asset Intelligence	`KAI_APP_USAGE_TIME_BATTERY`: Battery data of app usage.	Periodically reports battery data of app usage after every 3 hours.
Knox Asset Intelligence	`KAI_APP_USAGE_NETWORK`: Network data of app usage.	Periodically reports network data of app usage after every 3 hours.
Knox Asset Intelligence	`KAI_APP_USAGE_SCREENTIME`: Screen time data of app usage.	Periodically reports screen time data of app usage after every 3 hours.
Knox Asset Intelligence	`KAI_BATTERY_CHARGING`: Battery charing.	Reports details about the battery charging event as the event occurs.
Knox Asset Intelligence	`KAI_BATTERY_LEVEL_SHIFT_START`: Battery level at work shift start.	Reports details about the battery level of the device at the start of a work shift.
Knox Asset Intelligence	`KAI_BATTERY_LEVEL_SHIFT_END`: Battery level at work shift end.	Reports details about the battery level of the device at the end of a work shift.
Knox Asset Intelligence	`KAI_BATTERY_LEVEL_TRIGGERED`: Battery level threshold trigger.	Reports when the battery level is below a threshold, configured using the Set Triggered threshold of Battery level API.
Knox Asset Intelligence	`KAI_APP_ANR_FC`: App no response and force close events.	Reports ANR (App no response) and FC (Force close) eventson the device.
Knox Asset Intelligence	`KAI_WIFI_DISCONNECTIONS`: Wi-Fi abnormal disconnections.	Reports abnormal Wi-Fi disconnection eventson the device.
Knox Asset Intelligence	`KAI_BATTERY_STATUS`: Battery status.	Reports device battery status.
Knox Asset Intelligence	`KAI_DEVICE_DIAGNOSTICSLOGS`: Device diagnostics logs.	Sends device diagnostics logs.
Knox Guard	`KG_DEVICE_ENROLLED`: Device enrollment.	Enrolls a device to Knox Guard.
Knox Guard	`KG_DEVICE_RELOCK_TIMESTAMP_APPLIED`: Device relock timestamping.	Updates the relock timestamp to the device.
Knox Guard	`KG_DEVICE_LOCKED`: Device lock.	Locks an enrolled device.
Knox Guard	`KG_DEVICE_UNLOCKED`: Device unlock.	Unlocks a locked device.

Back to release notes

Is this page helpful?