Skip Navigation
  1. BlackBerry Docs
  2. Cylance Endpoint Security
  3. Cylance User API guide
  4. Global list API
  5. Get safe scripts

Get safe scripts

Retrieve a list of items from the script safe list.
Service endpoint
/globallists/v2/script/whitelist/bulk?page=m&page_size=n
Optional query string parameters
—
Example
https://protectapi.cylance.com/globallists/v2/script/whitelist/bulk?page=2&page_size=50
Method
HTTP/1.1 GET
Request headers
  • Accept: application/json
  • Authorization: Bearer
    JWT Token returned by Auth API
     with the globallist:READ scope encoded

Request

Append the following optional query string parameters:
  • page: The page number to request, defaults to 1
  • page_size: The number of scripts to retrieve per page, defaults to 10

Response

Please see the Response status codes for more information.
Body: 

{
    "page_number": 1,
    "page_size": 10,
    "total_pages": 2,
    "total_number_of_items": 20,
    "page_items": [{
        "sha256": "5A56B16953451FFA1C79F2397DB92475E440D430E4B6FB6E188E5E9DBFC9DDE4",
        "file_path" : "/FileFolder1/FileFolder2",
        "description" : "I am adding this whitelist because this script file is safe and should not be blocked."
    }]

}
Where:
Field Name
Description
page_number
The current page number.
page_size
The page size (maximum is 200).
total_pages
The total amount of pages.
total_number_of_items
The total amount of items.
page_items
The list of zones belonging to the requested page, each displaying the following information:
  • SHA256: The script file that matches the hash will be allowed to execute regardless of the other script controls that have been configured for the tenant.
  • filePath: The file path that is used to describe the hash.
  • description: The description or reason of the safe list entry.

Request json schema

None