Step 2 — Call Knox cloud services APIs with access token

You can use the access token obtained in Step 1 – Get access token to call Knox cloud services APIs.

As a customer

After obtaining an access token using Knox OAuth 2.0 Authentication, you can make Knox cloud service API requests.

For example, a cURL request for Knox Asset Intelligence service:

curl --location 'https://api.samsungknox.com/kai/v1/settings' \
     --header 'Authorization: Bearer aB1cDE......fG2itijk'

A sample response for the Knox Asset Intelligence request above:

{ 
    "battery": 
        { "batteryLevelThresholds": [] },
    "enrollment": 
        { "allowEnrolledToKnoxConfigure": false } 
}

As an MSP

After obtaining an access token using Knox OAuth 2.0 Authentication, when you make Knox cloud service API requests, include the managed customer ID value in the x-wsm-managed-tenantid header. The managed customer ID is available on the Customers page of the Knox MSP Portal, and you can also retrieve it using Get customer information endpoints.

For example, a cURL request for Knox Asset Intelligence service:

curl --location 'https://api.samsungknox.com/kai/v1/settings' \
     --header 'Authorization: Bearer aB1cDE......fG2itijk' \
     --header 'x-wsm-managed-tenantid: 1123123123'

A sample response for the Knox Asset Intelligence request above:

{ 
    "battery": 
        { "batteryLevelThresholds": [] },
    "enrollment": 
        { "allowEnrolledToKnoxConfigure": false } 
}

Supported services

The Knox cloud services that support OAuth 2.0 are:

• Knox Asset Intelligence

• Knox Configure

• Knox Deployment Program

• Knox E-FOTA

• Knox Manage (exclusively for MSP partners)

• Knox Mobile Enrollment

• Knox MSP Portal

• Knox Webhook Notification