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",
  "display_name": "Front Door",
  "errors": [],
  "is_managed": false,
  "is_online": true,
  "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"
}

{
  "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",
  "display_name": "Front Door",
  "errors": [],
  "is_managed": false,
  "is_online": true,
  "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",
  "display_name": "Front Door",
  "errors": [],
  "is_managed": false,
  "is_online": true,
  "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 thermostat can be returned to its weekly program, the schedule that is configured on the device itself, releasing any hold that Seam has set.

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 camera can stream live video through a camera live view session. false while the camera is offline.

Boolean

Indicates whether the thermostat can be turned off.

Boolean

Indicates whether the lock supports unlocking with an access code.

Array of Enums (String)

required

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.

Enum values

access_code
lock
noise_detection
thermostat
battery
phone
pool

String (UUID)

required

Unique identifier for the account associated with the device.

String (ISO 8601)

required

Date and time at which the device object was created.

Object (String, Boolean values)

required

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. Keys set to null or to an empty string are omitted.

String (UUID)

required

ID of the device.

Enum (String)

required

Type of the device. The august_lock and yale_lock values are deprecated. Use yale_access_lock in place of august_lock, and yale_access_lock or yale_home_lock in place of yale_lock.

Enum values

akuvox_lock
august_lock
brivo_access_point
butterflymx_panel
avigilon_alta_entry
doorking_lock
genie_door
igloo_lock
linear_lock
lockly_lock
kwikset_lock
nuki_lock
salto_lock
schlage_lock
smartthings_lock
wyze_lock
yale_lock
yale_access_lock
yale_home_lock
yale_connect_lock
two_n_intercom
controlbyweb_device
ttlock_lock
igloohome_lock
four_suites_door
dormakaba_oracode_door
tedee_lock
akiles_lock
ultraloq_lock
yacan_lock
keyincode_lock
omnitec_lock
kisi_lock
aqara_lock
tuya_lock
eufy_lock
keynest_key
noiseaware_activity_zone
minut_sensor
ecobee_thermostat
nest_thermostat
honeywell_resideo_thermostat
tado_thermostat
sensi_thermostat
sensibo_thermostat
smartthings_thermostat
ios_phone
android_phone
ring_camera
tapo_camera
arlo_camera
reolink_camera
unifi_protect_camera
sonos_speaker
alertify_sensor
hayward_pool_system
hayward_pool

String

required

Display name of the device, defaults to nickname (if it is set) or properties.appearance.name, otherwise. Enables administrators and users to identify the device easily, especially when there are numerous devices.

Array of Objects

required

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.

Show properties

Enum (String)

required

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.

Enum values

account_disconnected
salto_ks_subscription_limit_exceeded
insufficient_permissions
dormakaba_sites_disconnected
device_offline
device_removed
hub_disconnected
device_disconnected
empty_backup_access_code_pool
august_lock_not_authorized
missing_device_credentials
auxiliary_heat_running
subscription_required
bridge_disconnected

String

required

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

String (ISO 8601)

required

Date and time at which Seam created the error.

Boolean

Indicates that the error is a connected account error.

Boolean

Indicates that the error is a device error.

Boolean (Always false)

required

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

required

The level.

Boolean

required

Indicates if an accessory keypad is connected to the device.

Object

Represents the current status of the battery charge level.

Show properties

Number

required

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

Enum (String)

required

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.

Enum values

critical
low
good
full

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

required

Device model-related properties.

Show properties

Boolean

Indicates whether the device can connect a accessory keypad.

String

required

Display name of the device model.

Boolean

Indicates whether the device has a built in accessory keypad.

String

required

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

String

required

deprecated

Deprecated. use device.display_name insteadName of the device.

Boolean

required

Indicates whether the device is online.

Array of Objects

required

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.

Show properties

Enum (String)

required

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.

Enum values

partial_backup_access_code_pool
many_active_backup_codes
third_party_integration_detected
ttlock_lock_gateway_unlocking_not_enabled
ttlock_weak_gateway_signal
power_saving_mode
temperature_threshold_exceeded
device_communication_degraded
scheduled_maintenance_window
device_has_flaky_connection
salto_ks_office_mode
salto_ks_privacy_mode
privacy_mode
salto_ks_subscription_limit_almost_reached
salto_ks_lock_access_code_support_removed
unknown_issue_with_phone
lockly_time_zone_not_configured
ultraloq_time_zone_unknown
time_zone_unknown
time_zone_mismatch
two_n_device_missing_timezone
hub_required_for_additional_capabilities
service_mode
provider_issue
keynest_unsupported_locker
accessory_keypad_setup_required
accessory_keypad_low_battery
unreliable_online_status
max_access_codes_reached
subscription_required_for_additional_capabilities
cloud_recording_not_enabled

String

required

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

String (ISO 8601)

required

Date and time at which Seam created the warning.

String (UUID)

required

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.

hardware

Object

Accessory keypad properties and state.

Show properties

Object

Keypad battery properties.

Show properties

Number

required

The level.

Boolean

required

Indicates if an accessory keypad is connected to the device.

Object

Represents the current status of the battery charge level.

Show properties

Number

required

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

Enum (String)

required

Enum values

critical
low
good
full

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

hardware