Update an Unmanaged Device

Update the properties of a specified unmanaged device

Updates the is_managed property of a specified unmanaged device to indicate whether Seam manages the device. An unmanaged device has a limited set of visible properties and a subset of supported events. You cannot control an unmanaged device. Any access codes on an unmanaged device are unmanaged. To control an unmanaged device with Seam, convert it to a managed device.

/devices/unmanaged/update

POSThttps://connect.getseam.com/devices/unmanaged/update

Authorization

api_keypat_with_workspaceconsole_session_with_workspace

Body

application/json

device_id*string (uuid)

is_managed*enum

true

Response

200400401

OK

Body

application/json

ok*boolean

Request

JavaScriptCurlPython

const response = await fetch('https://connect.getseam.com/devices/unmanaged/update', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer API Key",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "device_id": "123e4567-e89b-12d3-a456-426614174000",
      "is_managed": true
    }),
});
const data = await response.json();

Response

200

{
  "ok": false
}

Request

Specify the desired unmanaged device by including the corresponding device_id in the request body. In addition, in the request body, include the is_managed property, along with true as the replacement value. Note that setting is_managed to true converts the unmanaged device to a managed device.

Request Body Parameters

Parameter	Type	Description
device_id	String Required	ID of the desired device.
is_managed	Boolean Optional	Replacement value to indicate whether Seam manages the device.

Sample Request

Python

device_id = "882dd63f-db9b-4210-bac2-68372aa0aff7"
unmanaged_device_update = seam.devices.unmanaged.update(
    device = device_id,
    is_managed= True
)

pprint(unmanaged_device_update)

cURL (bash)

curl -X 'POST' \
  'https://connect.getseam.com/devices/unmanaged/update' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer ${API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "device_id": "882dd63f-db9b-4210-bac2-68372aa0aff7",
  "is_managed": true
}'

Javascript

const deviceId = "882dd63f-db9b-4210-bac2-68372aa0aff7"
const unmanagedDeviceUpdate = await seam.devices.unmanaged.update({
  device_id: deviceId,
  is_managed: true
})

console.log(unmanagedDeviceUpdate)

Ruby

device_id = "882dd63f-db9b-4210-bac2-68372aa0aff7"
unmanaged_device_update = client.unmanaged_devices.update(
  device_id: device_id,
  is_managed: true
)

puts unmanaged_device_update.inspect

Java

var deviceId = "882dd63f-db9b-4210-bac2-68372aa0aff7";

seam.devices().unmanaged().update(UnmanagedUpdateRequest.builder()
        .deviceId(deviceId)
        .isManaged(true)
        .build());

Response

Returns a Boolean ok status indicator (with the exception of the Java SDK).

Sample Response

Python

True

cURL (bash)

{
  "ok": true
}

JavaScript

{ ok: true }

Ruby

{"ok"=>true}