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

Boolean

Indicates whether the lock supports configuring automatic locking.

Boolean

Indicates whether the thermostat supports cooling.

Boolean

Indicates whether the thermostat supports heating.

Boolean

Indicates whether the thermostat supports simultaneous heating and cooling.

Boolean

Indicates whether the device supports programming offline access codes.

Boolean

Indicates whether the device supports programming online access codes.

Boolean

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

Boolean

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

Boolean

Indicates whether the thermostat supports weekday/weekend climate programs.

Boolean

Indicates whether the device supports remote locking.

Boolean

Indicates whether the device supports remote unlocking.

Boolean

Indicates whether the thermostat supports running climate programs.

Boolean

Indicates whether the device supports simulating connection in a sandbox.

Boolean

Indicates whether the device supports simulating disconnection in a sandbox.

Boolean

Indicates whether the hub supports simulating connection in a sandbox.

Boolean

Indicates whether the hub supports simulating disconnection in a sandbox.

Boolean

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

Boolean

Indicates whether the device supports simulating removal in a sandbox.

Boolean

Indicates whether the thermostat can be turned off.

Boolean

Indicates whether the lock supports unlocking with an access code.

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.

String (UUID)

Unique identifier for the account associated with the device.

String (ISO 8601)

Date and time at which the device object was created.

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.

String (UUID)

ID of the device.

Enum (String)

Type of the device.

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.

Boolean

Indicates that Seam does not manage the device.

Object

properties of the device.

Show properties

Object

Accessory keypad properties and state.

Show properties

Object

Keypad battery properties.

Show properties

number

The level.

Boolean

Indicates if an accessory keypad is connected to the device.

Object

Represents the current status of the battery charge level.

Show properties

number

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

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.

number

Indicates the battery level of the device as a decimal value between 0 and 1, inclusive.

String

Alt text for the device image.

String

Image URL for the device.

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.

Object

Device model-related properties.

Show properties

Boolean

deprecated

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

Boolean

Indicates whether the device can connect a accessory keypad.

String

Display name of the device model.

Boolean

Indicates whether the device has a built in accessory keypad.

String

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

Boolean

deprecated

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

Boolean

deprecated

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

String

deprecated

Deprecated. use device.display_name insteadName of the device.

Boolean

deprecated

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

Boolean

Indicates whether the device is online.

Boolean

deprecated

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

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.

String (UUID)

Unique identifier for the Seam workspace associated with the device.

Object

Location information for the device.

Show properties

String

Name of the device location.

String

Name of the room within the device location, when the provider reports one.

String

Time zone of the device location.

String

deprecated

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

access codes

Boolean

deprecated

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

Boolean

deprecated

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

hardware

Object

Accessory keypad properties and state.

Show properties

Object

Keypad battery properties.

Show properties

number

The level.

Boolean

Indicates if an accessory keypad is connected to the device.

Object

Represents the current status of the battery charge level.

Show properties

number

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

Enum (String)

number

Indicates the battery level of the device as a decimal value between 0 and 1, inclusive.

String

Alt text for the device image.

String

Image URL for the device.

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.

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