Skip Navigation

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.
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