What's new in the BlackBerry Web Services version 12.23 REST APIs

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

Updates to methods

Path

Description

GET /{tenantGuid}/api/v1/users

The query parameter now includes a “roleGuid” field to filter results based on the role assigned to the user (directly or indirectly via group).

Deprecated data types

The Malicious application data type has been deprecated due to the removal of features from BlackBerry Protect Mobile.

Deprecated data type properties

Data type: Application

The following properties have been deprecated due to the removal of features from BlackBerry Protect Mobile:
  • appScanState
  • appScanStateMessage

Data type: User device

The following properties have been deprecated due to the removal of features from BlackBerry Protect Mobile:
  • maliciousApplications
  • maliciousSystemApplications

Deprecated entities

The following entities are deprecated as they are associated with features that have been removed from BlackBerry Protect Mobile:
  • com.blackberry.mdm.common.entity.MtdSafeBrowsingSettings
  • com.blackberry.mdm.common.entity.mobilethreatdefence.RestrictedApplication
  • com.blackberry.mdm.common.entity.mobilethreatdefence.RestrictedDeveloperCertificate

BlackBerry Web Services fixed issues (UEM 12.23 QF2)

If you tried to use BlackBerry Web Services Applications routes (/api/v1/applications), Active Directory authentication failed, preventing access to the APIs. (EMM-159474)

When you used the GET /{tenantGuid}/api/v1/exchangeConfigurations API, the modernAuthentication value would always return false even if modern authentication was configured. (EMM-159049)

BlackBerry Web Services fixed issues

Using POST /{tenantGuid}/api/v1/users to add an Entra ID directory user to UEM did not work as expected and resulted in a 500 internal server error. (EMM-158609)

For Data type: Certificate information by type, the descriptions for bemsTrusts and bemsdocsTrusts have been updated to clarify that they are applicable only to UEM Cloud deployments where standalone SSL certificates have been added to the BlackBerry Enterprise Mobility Server configuration. (EMM-158128)

If you used GET /{tenantGuid}/api/v1/users to search for users with a specific administrator role, the returned results did not include users that were assigned the role indirectly through two or more levels of nested group membership. (EMM-158012)

If you used the REST API to search for users and set the isAdmin query option to true, users that inherited administrator privileges through group membership were not returned. (EMM-157443)

BlackBerry Web Services known issues

In a UEM Cloud environment, when using GET /{tenantGuid}/api/v1/exchangeConfigurations on a Microsoft Exchange gatekeeping connection for the BlackBerry Connectivity Node, the "modernAuthentication" value is returned as false even if modern authentication is enabled. (EMM-159049)