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

post

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.

Authorizations

api_keypat_with_workspaceconsole_session_with_workspace

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

device_idstring · uuidRequired

ID of the unmanaged device that you want to update.

is_managedboolean · enumOptional

Indicates whether the device is managed. Set this parameter to true to convert an unmanaged device to managed.

Possible values:

Responses

200

OK

application/json

okbooleanRequired

400

Bad Request

401

Unauthorized

post

/devices/unmanaged/update

HTTPcURLJavaScriptPython

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

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)

Javascript

Ruby

Java

Response

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

Sample Response

Python

True

cURL (bash)

JavaScript

Ruby