Skip Navigation
  1. BlackBerry Docs
  2. Cylance products
  3. Cylance User API guide
  4. Persona Desktop API
  5. Get Persona Desktop users

Get
Persona Desktop
 users

Request a page with a list of
Persona Desktop
 users belonging to a tenant.
Service endpoint
https://persona-{region-code}.cylance.com/persona-users?includeMeta=true&page=m&pageSize=n
Optional query string parameters
  • includeMeta: This includes the meta section at the end of the response when set to true. The meta section includes the page number, the page size, the total number of pages, and the total number of records.
  • page: This is the page number to request.
  • pageSize: This is the number of user records to retrieve per page.
Example
https://persona.cylance.com/persona-users?includeMeta=true&page=1&pageSize=100
Returns the first page with up to 100 users.
Method
HTTP/1.1 GET
Request headers
  • Accept: application/json
  • Authorization: Bearer
    JWT Token returned by Auth API
     with the personausers:list scope encoded

Request

None

Response

Please see the Response status codes for more information.

Response JSON schema

Field Name
Description
devices
This is the list of devices the
Persona Desktop
 users has logged in to.
  • id - This is the unique ID of the device.
  • ipAddress - This is the IP address of the device.
  • last_login_time - This is the date and time (in UTC) when the user last logged in to the device.
  • last_online_time - This is the date and time (in UTC) when the user was last online on this device.
  • name - This is the name of the device.
domainName
This is the name of the domain.
id
This is the unique identifier of the
Persona Desktop
 user.
last_event_time
This is the date and time (in UTC) of the last
Persona Desktop
 event for the user.
last_login_time
This is the date and time (in UTC) when the user last logged in.
last_online_time
This is the date and time (in UTC) when the user was last online.
state
This is the current state of the
Persona Desktop
 user.
  • OFFLINE - The user is offline.
  • ONLINE - The user is online.
userName
This is the name of the user.
zones
This is the list of zones the
Persona Desktop
 user is assigned to.
id - This is the unique ID of the zone.
name - This is the name of the zone.