Device

Device URIs and Actions

The following table indicates the URIs that you can append to the root URI, along with the actions you can take, and possible return codes you can receive.

Example of Using GET for Device

This example demonstrates how to obtain information about a device that is registered during an enrollment.

URI:

This example uses the following URI:

 https://Jeff245.cloudpath.net/admin/apiv2/yRCjJObWR6ER/enrollments/Enrollment-4718fcaa-d04f-43c3-a3f0-6ef3af6b9d59/device

where:

• https://Jeff245.cloudpath.net/admin/apiv2 is the root URI of the Cloudpath system being used (must include https, as shown)
• yRCjJObWR6ER is an example of an API key generated from the Configuration > API Keys section of the Cloudpath UI
• Enrollment-4718fcaa-d04f-43c3-a3f0-6ef3af6b9d59 is the GUID of the enrollment

Request Headers:

The following table shows the required request headers for this URI example, with an example value of an active token that must be pasted into the Authorization header value:

Request Body:

None required.

Action:

Response Body:

Once the request is sent, you will receive a "Status: 200 OK" if the GET is successful. The response body provides information about the device of the enrollment that was specified.

{
    "name": "Windows 10",
    "browser": "Chrome 8",
    "browserAgent": "Browser",
    "browserManufacturer": "Google Inc.",
    "browserVersion": "87.0.4280.141",
    "formFactor": "Computer",
    "links": [
        {
            "rel": "self",
            "href": "https://jeff245.cloudpath.net/admin/apiv2/yRCjJObWR6ER/enrollments/Enrollment-4718fcaa-d04f-43c3-a3f0-6ef3af6b9d59/device",
            "hreflang": null,
            "media": null,
            "title": null,
            "type": null,
            "deprecation": null
        },
        {
            "rel": "parent",
            "href": "/apiv2/yRCjJObWR6ER/enrollments/Enrollment-4718fcaa-d04f-43c3-a3f0-6ef3af6b9d59",
            "hreflang": null,
            "media": null,
            "title": null,
            "type": null,
            "deprecation": null
        }
    ]
}