Skip to content

What's new in the BlackBerry UEM version 12.9 REST APIs

For details about the new additions and changes discussed here, see the BlackBerry UEM 12.9 REST API Reference. You can view the API reference online or download it (unzip the contents and open the index file).

New paths and methods

Resource: Licensing

Path

Description

GET /{tenantGuid}/api/v1/licensing/groups

Get group-based licensing information.

Resource: Users

Path

Description

DELETE /{tenantGuid}/api/v1/users/{userGuid}/profiles

Remove one or more profiles that are assigned to a user account.

GET /{tenantGuid}/api/v1/users/{userGuid}/profiles

Get the profiles that are assigned to a user account.

Note: This is a new implementation of this method that replaces a previous, deprecated iteration.

GET /{tenantGuid}/api/v1/users/{userGuid}/userDevices/{userDeviceGuid}/profiles

Get the effective profiles that are assigned to a user's device. Effective profiles are the profiles that are or will be delivered to a device. Some assigned profiles may not be delivered due to OS or version compatibility.

Improvements to existing paths and methods

Resource: Users

Path

Improvement

GET /{tenantGuid}/api/v1/users/{userGuid}/userDevices

Returns device compliance and location information.

Resource: Devices

Path

Improvement

GET /{tenantGuid}/api/v1/devices

You can filter devices by activation date and ownership.

Resource: Info

Path

Improvement

GET /{tenantGuid}/api/v1/info/systeminfo

Returns organization SRP details and license type information.

New data types

Type

Description

Geolocation

Contains data about the geographical location point of a device

Group Licensing

Contains data about unassigned licenses and per-group licensing data

Group Licensing Information

Contains licensing information for each group in a licensing information response

Groups Licensing Information

Contains an organization's group licensing information response

Out of compliance information

Out of compliance details for a user's device

Profile assignment

A profile that is assigned to a user account

Profile assignments

A collection of profile assignments

Unassigned License Details

Unassigned license purchase details for group licensing information; does not apply to non-group licensing

Unassigned Licenses

Information about unassigned licenses for group licensing; does not apply to non-group licensing

Changes to data types

Data type

Changes

Profile

The following property has been added:
  • description: The description of the profile.

Profile categories

The following values have been added to this data type to replace existing values that have been deprecated:
  • BLACKBERRY_DYNAMICS_CONNECTIVITY replaces GOOD_DYNAMICS_CONNECTIVITY
  • BLACKBERRY_DYNAMICS_SECURITY replaces GOOD_DYNAMICS_SECURITY

The GOOD_DYNAMICS_CONNECTIVITY and GOOD_DYNAMICS_SECURITY values are still supported in this release, but will be removed in an upcoming release. See the profile categories data type in the BlackBerry UEM 12.9 REST API Reference for more information.

System info

The following properties have been added to this data type:
  • srpId
  • srpKey
  • licensingType
  • srpServer
  • srpPort

User device

The following properties have been added to this data type:
  • outOfComplianceInfo
  • deviceLocation