Unmanaged Devices

Learn how the unmanaged_device object exposes a limited set of properties and events for a device you cannot control until you convert it to managed.

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.

Unmanaged 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.

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

The 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

The offline access codes supported.

online_access_codes_supported · Boolean · deprecated

The online access codes supported.

name · String · deprecated

Name of the device.

offline_access_codes_enabled · Boolean · deprecated

Indicates 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

Indicates 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

Time zone of the device location.

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.

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.