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

For more information, see Response status codes.

Request JSON schema

Field Name Description

add_zone_ids

The list of zone identifiers to be assigned to the device.

name

The name of the device.

policy_id

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

The list of zone identifiers to be removed from the device.