Unmanaged Devices

{
  "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"
}

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

Indicates whether the lock supports configuring automatic locking.

can_hvac_cool

Boolean

Indicates whether the thermostat supports cooling.

can_hvac_heat

Boolean

Indicates whether the thermostat supports heating.

can_hvac_heat_cool

Boolean

Indicates whether the thermostat supports simultaneous heating and cooling.

can_program_offline_access_codes

Boolean

Indicates whether the device supports programming offline access codes.

can_program_online_access_codes

Boolean

Indicates whether the device supports programming online access codes.

can_program_thermostat_programs_as_different_each_day

Boolean

Indicates whether the thermostat supports different climate programs for each day of the week.

can_program_thermostat_programs_as_same_each_day

Boolean

Indicates whether the thermostat supports a single climate program applied to every day.

can_program_thermostat_programs_as_weekday_weekend

Boolean

Indicates whether the thermostat supports weekday/weekend climate programs.

can_remotely_lock

Boolean

Indicates whether the device supports remote locking.

can_remotely_unlock

Boolean

Indicates whether the device supports remote unlocking.

can_run_thermostat_programs

Boolean

Indicates whether the thermostat supports running climate programs.

can_simulate_connection

Boolean

Indicates whether the device supports simulating connection in a sandbox.

can_simulate_disconnection

Boolean

Indicates whether the device supports simulating disconnection in a sandbox.

can_simulate_hub_connection

Boolean

Indicates whether the hub supports simulating connection in a sandbox.

can_simulate_hub_disconnection

Boolean

Indicates whether the hub supports simulating disconnection in a sandbox.

can_simulate_paid_subscription

Boolean

Indicates whether the device supports simulating a paid subscription in a sandbox.

can_simulate_removal

Boolean

Indicates whether the device supports simulating removal in a sandbox.

can_turn_off_hvac

Boolean

Indicates whether the thermostat can be turned off.

can_unlock_with_code

Boolean

Indicates whether the lock supports unlocking with an access 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

Indicates that Seam does not manage the device.

properties

Object

properties of the device.

Show properties

accessory_keypad

Object

Accessory keypad properties and state.

Show properties

battery

Object

Keypad battery properties.

Show properties

level

number

The level.

is_connected

Boolean

Indicates if an accessory keypad is connected to the device.

battery

Object

Represents the current status of the battery charge level.

Show properties

level

number

Battery charge level as a value between 0 and 1, inclusive.

status

Enum (String)

Represents the current status of the battery charge level. Values are critical, which indicates an extremely low level, suggesting imminent shutdown or an urgent need for charging; low, which signifies that the battery is under the preferred threshold and should be charged soon; good, which denotes a satisfactory charge level, adequate for normal use without the immediate need for recharging; and full, which represents a battery that is fully charged, providing the maximum duration of usage.

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.

model

Object

Device model-related properties.

Show properties

accessory_keypad_supported

Boolean

deprecated

Deprecated. use device.properties.model.can_connect_accessory_keypadThe accessory keypad supported.

can_connect_accessory_keypad

Boolean

Indicates whether the device can connect a accessory keypad.

display_name

String

Display name of the device model.

has_built_in_keypad

Boolean

Indicates whether the device has a built in accessory keypad.

manufacturer_display_name

String

Display name that corresponds to the manufacturer-specific terminology for the device.

offline_access_codes_supported

Boolean

deprecated

Deprecated. use device.can_program_offline_access_codes.The offline access codes supported.

online_access_codes_supported

Boolean

deprecated

Deprecated. use device.can_program_online_access_codes.The online access codes supported.

name

String

deprecated

Deprecated. use device.display_name insteadName of the device.

offline_access_codes_enabled

Boolean

deprecated

Deprecated. use device.can_program_offline_access_codesIndicates whether it is currently possible to use offline access codes for the device.

online

Boolean

Indicates whether the device is online.

online_access_codes_enabled

Boolean

deprecated

Deprecated. use device.can_program_online_access_codesIndicates whether it is currently possible to use online access codes for 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.

Show properties

location_name

String

Name of the device location.

time_zone

String

Time zone of the device location.

timezone

String

deprecated

Deprecated. Use time_zone instead.Time zone of the device location.

access codes

offline_access_codes_enabled

Boolean

deprecated

Deprecated. use device.can_program_offline_access_codesIndicates whether it is currently possible to use offline access codes for the device.

online_access_codes_enabled

Boolean

deprecated

Deprecated. use device.can_program_online_access_codesIndicates whether it is currently possible to use online access codes for the device.

hardware

accessory_keypad

Object

Accessory keypad properties and state.

Show properties

battery

Object

Keypad battery properties.

Show properties

level

number

The level.

is_connected

Boolean

Indicates if an accessory keypad is connected to the device.

battery

Object

Represents the current status of the battery charge level.

Show properties

level

number

Battery charge level as a value between 0 and 1, inclusive.

status

Enum (String)

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.

Paid subscription Unmanaged Devices Events

Getting Started

Granting Access

Devices and Systems

Setup

Monitoring

Low-Level APIs

Unmanaged Devices

The unmanaged_device Object

Properties

access codes

hardware

​The unmanaged_device Object

​Properties

​access codes

​hardware

The unmanaged_device Object

Properties

access codes

hardware