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.
Updates a specified unmanaged device. To convert an unmanaged device to managed, set is_managed to true.
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.
ID of the unmanaged device that you want to update.
Indicates whether the device is managed. Set this parameter to true to convert an unmanaged device to managed.
OK
Bad Request
Unauthorized
POST /devices/unmanaged/update HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 123
{
"device_id": "123e4567-e89b-12d3-a456-426614174000",
"is_managed": true,
"custom_metadata": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
}{
"ok": true
}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
device_id
String Required
ID of the desired device.
is_managed
Boolean Optional
Replacement value to indicate whether Seam manages the device.
Sample Request
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 -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
}'const deviceId = "882dd63f-db9b-4210-bac2-68372aa0aff7"
const unmanagedDeviceUpdate = await seam.devices.unmanaged.update({
device_id: deviceId,
is_managed: true
})
console.log(unmanagedDeviceUpdate)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.inspectvar 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
True{
"ok": true
}{ ok: true }{"ok"=>true}Last updated
Was this helpful?