Get policies

Request a page with a list of console policies belonging to a tenant, sorted by modified date, in descending order (most recently modified policy listed first). The page number and page size parameters are optional. When the values are not specified, these default to 1 and 10 respectively. When a policy is created, the modified date is the same as the created date, until the policy is modified.

Service endpoint

/policies/v2?page=m&page_size=n

Optional query string parameters

  • page: This is the page number to request.
  • page_size: This is the number of device records to retrieve per page.

Example

Return the first page with up to 100 policies: https://protectapi.cylance.com/policies/v2?page=1&page_size=100

Method

HTTP/1.1 GET

Request headers

  • Accept: application/json
  • Authorization: Bearer JWT Token returned by Auth API with the policy:list scope encoded

Request

None

Response

Please see the Response status codes for more information.

Response JSON schema

Field Name Description

date_added

This is the date and time (in UTC) when the console policy resource was first created.

date_modified

This is the date and time (in UTC) when the console policy resource was last modified.

device_count

This is the number of devices assigned to this policy.

id

This is the unique ID for the policy resource.

name

This is the name of the policy.

page_number

This is the page number requested.

page_size

This is the page size requested.

total_number_of_items

This is the total number of resources.

total_pages

This is the total number of pages that can be retrieved based on the page size specified.

zone_count

This is the number of zones assigned to this policy.