Update device

Update a specific device resource belonging to a tenant.

Service endpoint

/devices/v2/{unique_device_id}

Optional query string parameters

—

Example

https://protectapi.cylance.com/devices/v2/e378dacb-9324-453a-b8c6-5a8406952195

Method

HTTP/1.1 PUT

Request headers
  • Accept: application/json
  • Authorization: Bearer JWT Token returned by Auth API with the device:update scope encoded
  • Content-Type: application/json

Request

JSON 
{
    "name": "User-Laptop-A123",
    "policy_id": "d5c6d6a3-0599-4fb5-96bc-0fdc7eacb6ea",
    "add_zone_ids": [
        "d27ff5c4-5c0d-4f56-a00d-a1fb297e440e"
        ],
    "remove_zone_ids": [
        "639db7f7-c7f9-488d-b834-41c4522b32b6"
    ]
}

Response

Please see the Response status codes for more information.

Request JSON schema

Field Name Description

add_zone_ids

This is the list of zone identifiers which the device is to be assigned.

name

This is the name of the device.

policy_id

This is the unique identifier for the policy to assign to the device (specify as null or leave the string empty to remove the current policy from the device).

remove_zone_ids

This is the list of zone identifiers from which the device is to be removed.