Back to top

Knox Webhook Notification 23.12 What’s New

Last updated December 6th, 2023

Find out what’s new in this release of the Knox Webhook Notification REST APIs:

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 What's New

Is this page helpful?