Update a Device

Update the properties of a specified device

Updates any of the following properties of a specified device:

• name (or properties.name)

• custom_metadata

• is_managed

/devices/update

post

Authorizations

api_keypat_with_workspaceconsole_session_with_workspaceclient_session

Body

device_idstring · uuidrequired

propertiesobjectoptional

namestring | nullableoptional

is_managedboolean · default: trueoptional

custom_metadataobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://connect.getseam.com/devices/update' \
  --header 'Authorization: Bearer API Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "device_id": "123e4567-e89b-12d3-a456-426614174000",
    "properties": {
      "name": "text"
    },
    "name": "text",
    "is_managed": true,
    "custom_metadata": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  }'

200

400

401

200

{
  "ok": true
}

OK

Request

Specify the desired device by including the corresponding device_id in the request body. In addition, in the request body, include the properties that you want to update, along with the desired replacement values.

Request Body Parameters

Parameter	Type	Description
device_id	String Required	ID of the desired device.
name (or properties.name)	String Optional	Replacement name for the device.
custom_metadata	JSON object Optional	Custom metadata for the device. Specify up to 50 keys, with key names up to 40 characters long. Accepts string or Boolean values. Strings are limited to 500 characters. For more information, see Adding Custom Metadata to Devices.
is_managed	Boolean Optional	Replacement value to indicate whether Seam manages the device.

Sample Request

Python

device_update = seam.devices.update(
    device = "30fd243b-3054-4384-a713-5487076a3826",
    name = "My Lock",
    custom_metadata = {
        "internal_account_id": "user-1"
    }
)

pprint(device_update)

cURL (bash)

curl -X 'POST' \
  'https://connect.getseam.com/devices/update' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer ${API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "device_id": "30fd243b-3054-4384-a713-5487076a3826",
  "name": "My Lock",
  "custom_metadata": {
    "id": "internal_id_1"
  }
}'

Javascript

const deviceUpdate = await seam.devices.update({
  device_id: "30fd243b-3054-4384-a713-5487076a3826",
  name: "My Lock",
  custom_metadata: {
    "internal_account_id": "user-1"
  }
})

console.log(deviceUpdate)

Ruby

device_update = client.devices.update(
  device_id: "30fd243b-3054-4384-a713-5487076a3826",
  name: "My Lock",
  custom_metadata: {
    "internal_account_id": "user-1"
  }
)

puts device_update.inspect

PHP

$device_update = $seam->devices->update(
  device_id: "30fd243b-3054-4384-a713-5487076a3826",
  name: "My Lock",
  custom_metadata: array('internal_account_id' => 'user-1')
)
echo json_encode($device_update, JSON_PRETTY_PRINT);

Java

Map<String, CustomMetadataValue> customMetadata =
    Map.of("internal_account_id", CustomMetadataValue.of(Optional.of("user-1")));

seam.devices().update(DevicesUpdateRequest.builder()
        .deviceId("30fd243b-3054-4384-a713-5487076a3826")
        .name("My Lock")
        .custom_metadata(customMetadata)
        .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}

PHP

true