What's new in the BlackBerry Web Services for BlackBerry UEM version 12.12 MR1 REST APIs Skip Navigation

What's new in the 
BlackBerry Web Services
 for 
BlackBerry UEM
 version 12.12 MR1 REST APIs

For details about the new features and updates discussed here, see the BlackBerry UEM 12.12 MR1 REST API Reference.

Support for new entity definitions

The 
BlackBerry Web Services
 version 12.12 introduced entities, a generic interface that provides more dynamic functionality to the REST APIs. By using the generic entity interface and metadata, apps can dynamically expose new features and functionality from 
UEM
 (for example, new profile types or new settings within profiles) without requiring API changes.
The 12.12 MR1 release adds support for new entity definitions. For more information, see Getting started: Entities.

Changes to existing paths and methods

Resource: Applications
Path
Changes
GET /{tenantGuid}/api/v1/applications
Returns appScanState
GET /{tenantGuid}/api/v1/applications/{appGuid}
Returns appScanState
GET /{tenantGuid}/api/v1/applications/{appGuid}/{osFamily}
Returns appScanState
Resource: Entities
Path
Changes
POST /{tenantGuid}/api/v1/entities/{entityDefId}
Updated with CylancePROTECT settings
PUT /{tenantGuid}/api/v1/entities/{entityDefId}
Updated with CylancePROTECT settings
CRUD operations are now supported for compliance profiles and all related entities. For more information, see Getting started: Entities.
Resource: Groups
Path
Changes
GET /{tenantGuid}/api/v1/groups
Supports prefix matching for a group name
Resource: Users
Path
Changes
GET /{tenantGuid}/api/v1/users
The query request parameter supports searching for users by ecoid
GET /{tenantGuid}/api/v1/users/{userGuid}/userDevices
Returns sideloadedApplications
GET /{tenantGuid}/api/v1/users/{userGuid}/userDevices/
{userDeviceGuid}
Returns sideloadedApplications

New data types

Type
Description
Record
Indicates that a setting is a collection of fields, possibly of different data types.
Sideloaded application
The package and name of a sideloaded application.
Sideloaded applications
Identifies sideloaded applications and signing identities.
Signing identity
A signing identity.
Time interval
Indicates that the setting represents an interval of time, in seconds.

Changes to data types

Type
Description
Application
The appScanState property has been added to support CylancePROTECT features.
Attestation info
The subStatus property has been added to provide the sub-status of app attestation.
User device
The following properties have been added to support CylancePROTECT features:
  • maliciousSystemApplications
  • sideloadedApplications