Unmanaged Devices Errors and Warnings

Errors

Each error is an object with the following shape:

Example error

{
  "error_code": "account_disconnected",
  "message": "Indicates that the account is disconnected.",
  "created_at": "2025-01-01T00:00:00.000Z",
  "is_connected_account_error": true,
  "is_device_error": true
}

Error object properties

Enum (String)

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.One of the error codes listed below.

String

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

String (ISO 8601)

Date and time at which Seam created the error.

Boolean

Indicates whether the error is related to Seam Bridge.

Boolean

Indicates that the error is a connected account error.

Boolean

Indicates that the error is not a device error.

`device_disconnected`

Indicates that the device is disconnected.

`device_offline`

Indicates that the device is offline.

`device_removed`

Indicates that the device has been removed.

`hub_disconnected`

Indicates that the hub is disconnected.

`missing_device_credentials`

Indicates that device credentials are missing.

`subscription_required`

Indicates that a subscription is required to connect.

Access Codes

`empty_backup_access_code_pool`

Indicates that the backup access code pool is empty.

Locks

`august_lock_not_authorized`

Indicates that the user is not authorized to use the August lock.

Thermostats

`auxiliary_heat_running`

Indicates that the auxiliary heat is running.

Connected Account

These errors are inherited from the Connected Account resource. When they are set on the parent connected account, they are propagated to this resource’s errors list.

`account_disconnected`

Indicates that the account is disconnected.

`bridge_disconnected`

Indicates that the Seam API cannot communicate with Seam Bridge, for example, if the Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline. See also Troubleshooting Your Access Control System.

`dormakaba_sites_disconnected`

Indicates that one or more dormakaba sites associated with the connected account could not be connected. Contact dormakaba support.

`salto_ks_subscription_limit_exceeded`

Indicates that the Salto site user limit has been reached.

Warnings

Each warning is an object with the following shape:

Example warning

{
  "warning_code": "partial_backup_access_code_pool",
  "message": "Indicates that the backup access code is unhealthy.",
  "created_at": "2025-01-01T00:00:00.000Z"
}

Warning object properties

Enum (String)

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.One of the warning codes listed below.

String

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

String (ISO 8601)

Date and time at which Seam created the warning.

number

Number of active access codes on the device when the warning was set.

number

Maximum number of active access codes supported by the device.

`device_communication_degraded`

Indicates that the device appears to be unresponsive.

`device_has_flaky_connection`

Indicates that the device has a flaky connection.

`scheduled_maintenance_window`

Indicates that a scheduled maintenance window has been detected.

`third_party_integration_detected`

Indicates that a third-party integration has been detected.

Access Codes

`many_active_backup_codes`

Indicates that there are too many backup codes.

`max_access_codes_reached`

Indicates that the device has reached its maximum number of active access codes. Delete existing codes before creating new ones.

`partial_backup_access_code_pool`

Indicates that the backup access code is unhealthy.

`privacy_mode`

Indicates that the lock is in Privacy Mode. Access codes and remote unlock are blocked until Privacy Mode is disabled.

`provider_issue`

Indicates a provider-specific issue that may affect device functionality.

`salto_ks_lock_access_code_support_removed`

Indicates that a change in the reported device model has been detected for this Salto KS lock, which may occur after an IQ hub reset. Access code support may be affected. See https://help.getseam.com/articles/5098842588-salto-ks-lock-loses-access-code-support for troubleshooting steps.

`salto_ks_office_mode`

Indicates that the Salto KS lock is in Office Mode. Access Codes will not unlock doors.

`salto_ks_privacy_mode`

Indicates that the Salto KS lock is in Privacy Mode. Access Codes will not unlock doors.

Locks

`accessory_keypad_setup_required`

Indicates that the accessory keypad exists, but is not linked to the Igloohome Bridge. Online access code programming will fail until the keypad is linked to the Igloohome Bridge in the Igloohome app.

`hub_required_for_additional_capabilities`

Indicates that a hub or relay must be connected to unlock additional capabilities such as remote unlock.

`insufficient_permissions`

Indicates that the connected Kwikset account has member-level access to this lock’s home. Admin or owner access is required to manage access codes and control the lock remotely.

`keynest_unsupported_locker`

Indicates that the key is in a locker that does not support the access codes API.

`lockly_time_zone_not_configured`

Indicates that Seam detected that the Lockly device does not have a time zone configured. Time-bound codes may not work as expected.

`power_saving_mode`

Indicates that the device is in power saving mode and may have limited functionality.

`salto_ks_subscription_limit_almost_reached`

Indicates that the Salto KS site has exceeded 80% of the maximum number of allowed users. Increase your subscription limit or delete some users from your site.

`time_zone_mismatch`

Indicates that the device’s configured time zone does not match its hardware UTC offset. Time-bound access codes may activate at the wrong local time.

`time_zone_unknown`

Indicates that Seam does not know the device’s time zone. Set a time zone to enable time-bound access codes.

`ttlock_lock_gateway_unlocking_not_enabled`

Indicates that the Remote Unlock feature is not enabled in the settings.”

`ttlock_weak_gateway_signal`

Indicates that the gateway signal is weak.

`two_n_device_missing_timezone`

Indicates that the 2N device does not have a time zone configured. Configure a time zone on the device to enable access codes.

`ultraloq_time_zone_unknown`

Indicates that Seam does not know the time zone of the Ultraloq device. Set a time zone to enable time-bound access codes.

`unreliable_online_status`

Indicates that the device may optimistically be reported as online because the provider does not reliably report its online status.

Phones

`unknown_issue_with_phone`

Indicates that an unknown issue occurred while syncing the state of the phone with the provider. This issue may affect the proper functioning of the phone.

Thermostats

`temperature_threshold_exceeded`

Indicates that the temperature threshold has been exceeded.

​Errors

​device_disconnected

​device_offline

​device_removed

​hub_disconnected

​missing_device_credentials

​subscription_required

​Access Codes

​empty_backup_access_code_pool

​Locks

​august_lock_not_authorized

​Thermostats

​auxiliary_heat_running

​Connected Account

​account_disconnected

​bridge_disconnected

​dormakaba_sites_disconnected

​salto_ks_subscription_limit_exceeded

​Warnings

​device_communication_degraded

​device_has_flaky_connection

​scheduled_maintenance_window

​third_party_integration_detected

​Access Codes

​many_active_backup_codes

​max_access_codes_reached

​partial_backup_access_code_pool

​privacy_mode

​provider_issue

​salto_ks_lock_access_code_support_removed

​salto_ks_office_mode

​salto_ks_privacy_mode

​Locks

​accessory_keypad_setup_required

​hub_required_for_additional_capabilities

​insufficient_permissions

​keynest_unsupported_locker

​lockly_time_zone_not_configured

​power_saving_mode

​salto_ks_subscription_limit_almost_reached

​time_zone_mismatch

​time_zone_unknown

​ttlock_lock_gateway_unlocking_not_enabled

​ttlock_weak_gateway_signal

​two_n_device_missing_timezone

​ultraloq_time_zone_unknown

​unreliable_online_status

​Phones

​unknown_issue_with_phone

​Thermostats

​temperature_threshold_exceeded

Errors

`device_disconnected`

`device_offline`

`device_removed`

`hub_disconnected`

`missing_device_credentials`

`subscription_required`

Access Codes

`empty_backup_access_code_pool`

Locks

`august_lock_not_authorized`

Thermostats

`auxiliary_heat_running`

Connected Account

`account_disconnected`

`bridge_disconnected`

`dormakaba_sites_disconnected`

`salto_ks_subscription_limit_exceeded`

Warnings

`device_communication_degraded`

`device_has_flaky_connection`

`scheduled_maintenance_window`

`third_party_integration_detected`

Access Codes

`many_active_backup_codes`

`max_access_codes_reached`

`partial_backup_access_code_pool`

`privacy_mode`

`provider_issue`

`salto_ks_lock_access_code_support_removed`

`salto_ks_office_mode`

`salto_ks_privacy_mode`

Locks

`accessory_keypad_setup_required`

`hub_required_for_additional_capabilities`

`insufficient_permissions`

`keynest_unsupported_locker`

`lockly_time_zone_not_configured`

`power_saving_mode`

`salto_ks_subscription_limit_almost_reached`

`time_zone_mismatch`

`time_zone_unknown`

`ttlock_lock_gateway_unlocking_not_enabled`

`ttlock_weak_gateway_signal`

`two_n_device_missing_timezone`

`ultraloq_time_zone_unknown`

`unreliable_online_status`

Phones

`unknown_issue_with_phone`

Thermostats

`temperature_threshold_exceeded`