Back to top

Knox Webhook Notification 23.09 What’s New

Last updated November 17th, 2022

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.

The Knox Webhook Notification API currently supports subscription calls to the following Knox cloud service events:

Knox cloud service Event Description
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.
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.
Back to What's New

Is this page helpful?