Skip to main content

The unmanaged_device Object

Represents an unmanaged 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.
{
  "can_program_offline_access_codes": false,
  "can_program_online_access_codes": true,
  "can_remotely_lock": true,
  "can_remotely_unlock": true,
  "can_simulate_connection": false,
  "can_simulate_disconnection": true,
  "can_simulate_removal": true,
  "capabilities_supported": [
    "access_code",
    "lock"
  ],
  "connected_account_id": "c1a3967f-24a1-4220-a9c7-7fa97c1d5603",
  "created_at": "2025-06-16T16:54:17.946342Z",
  "device_id": "f4f40e75-86fc-4896-b958-e1c7e092b2cf",
  "device_type": "schlage_lock",
  "errors": [],
  "is_managed": false,
  "location": {
    "location_name": "Front Door",
    "timezone": "America/New_York"
  },
  "custom_metadata": {
    "id": "internalId1"
  },
  "properties": {
    "accessory_keypad": {
      "battery": {
        "level": 1
      },
      "is_connected": true
    },
    "battery": {
      "level": 1,
      "status": "full"
    },
    "battery_level": 1,
    "image_alt_text": "Schlage Sense Smart Deadbolt with Camelot Trim, Front",
    "image_url": "https://connect.getseam.com/_next/image?url=https://connect.getseam.com/assets/images/devices/schlage_sense-smart-deadbolt-with-camelot-trim_front.png&q=75&w=128",
    "manufacturer": "schlage",
    "model": {
      "accessory_keypad_supported": true,
      "can_connect_accessory_keypad": true,
      "display_name": "Front Door",
      "has_built_in_keypad": false,
      "manufacturer_display_name": "Schlage",
      "offline_access_codes_supported": false,
      "online_access_codes_supported": true
    },
    "name": "Front Door",
    "offline_access_codes_enabled": false,
    "online": true,
    "online_access_codes_enabled": true
  },
  "warnings": [],
  "workspace_id": "3cd6ba1c-8a60-4c24-b487-07bf6c0b755b"
}

Properties

can_configure_auto_lock
Boolean
The can configure auto lock.
can_hvac_cool
Boolean
The can hvac cool.
can_hvac_heat
Boolean
The can hvac heat.
can_hvac_heat_cool
Boolean
The can hvac heat cool.
can_program_offline_access_codes
Boolean
The can program offline access codes.
can_program_online_access_codes
Boolean
The can program online access codes.
can_program_thermostat_programs_as_different_each_day
Boolean
The can program thermostat programs as different each day.
can_program_thermostat_programs_as_same_each_day
Boolean
The can program thermostat programs as same each day.
can_program_thermostat_programs_as_weekday_weekend
Boolean
The can program thermostat programs as weekday weekend.
can_remotely_lock
Boolean
The can remotely lock.
can_remotely_unlock
Boolean
The can remotely unlock.
can_run_thermostat_programs
Boolean
The can run thermostat programs.
can_simulate_connection
Boolean
The can simulate connection.
can_simulate_disconnection
Boolean
The can simulate disconnection.
can_simulate_hub_connection
Boolean
The can simulate hub connection.
can_simulate_hub_disconnection
Boolean
The can simulate hub disconnection.
can_simulate_paid_subscription
Boolean
The can simulate paid subscription.
can_simulate_removal
Boolean
The can simulate removal.
can_turn_off_hvac
Boolean
The can turn off hvac.
can_unlock_with_code
Boolean
The can unlock with code.
capabilities_supported
Array
Collection of capabilities that the device supports when connected to Seam. Values are access_code, which indicates that the device can manage and utilize digital PIN codes for secure access; lock, which indicates that the device controls a door locking mechanism, enabling the remote opening and closing of doors and other entry points; noise_detection, which indicates that the device supports monitoring and responding to ambient noise levels; thermostat, which indicates that the device can regulate and adjust indoor temperatures; battery, which indicates that the device can manage battery life and health; and phone, which indicates that the device is a mobile device, such as a smartphone. Important: Superseded by capability flags.
connected_account_id
String (UUID)
Unique identifier for the account associated with the device.
created_at
String (ISO 8601)
Date and time at which the device object was created.
custom_metadata
object
Set of key:value pairs. Adding custom metadata to a resource, such as a Connect Webview, connected account, or device, enables you to store custom information, like customer details or internal IDs from your application.
device_id
String (UUID)
ID of the device.
device_type
Enum (String)
Type of the device.
errors
Array
Array of errors associated with the device. Each error object within the array contains two fields: error_code and message. error_code is a string that uniquely identifies the type of error, enabling quick recognition and categorization of the issue. message provides a more detailed description of the error, offering insights into the issue and potentially how to rectify it.
is_managed
Boolean
The is managed.
properties
Object
properties of the device.
warnings
Array
Array of warnings associated with the device. Each warning object within the array contains two fields: warning_code and message. warning_code is a string that uniquely identifies the type of warning, enabling quick recognition and categorization of the issue. message provides a more detailed description of the warning, offering insights into the issue and potentially how to rectify it.
workspace_id
String (UUID)
Unique identifier for the Seam workspace associated with the device.
location
Object
Location information for the device.

access codes

offline_access_codes_enabled
Boolean
deprecated
Indicates whether it is currently possible to use offline access codes for the device.
online_access_codes_enabled
Boolean
deprecated
Indicates whether it is currently possible to use online access codes for the device.

hardware

accessory_keypad
Object
Accessory keypad properties and state.
battery
Object
Represents the current status of the battery charge level.
battery_level
number
Indicates the battery level of the device as a decimal value between 0 and 1, inclusive.
image_alt_text
String
Alt text for the device image.
image_url
String
Image URL for the device.
manufacturer
String
Manufacturer of the device. When a device, such as a smart lock, is connected through a smart hub, the manufacturer of the device might be different from that of the smart hub.