Errors
Each error is an object with the following shape:Example error
Error object properties
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.
Enum (String)
Indicates the type of external modification.
modified means the code’s PIN or schedule was changed. removed means the code was deleted from the device.Boolean
Indicates that this is an access code 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.
String (UUID)
ID of the managed access code that conflicts with this managed access code, when Seam can identify it.
Array
List of fields that were changed externally, with their previous and new values.
String (UUID)
ID of the unmanaged access code that conflicts with this managed access code, when Seam can identify it.
access_code_inactive
Indicates that the access code is disabled or inactive on the device. The code exists but will not grant access until re-enabled.
conflicting_external_modification
Code was modified or removed externally after Seam successfully set it on the device. The external change conflicts with the state that Seam is trying to apply, so Seam will attempt to set the code on the device again.
duplicate_code_on_device
Duplicate access code detected on device.
failed_to_remove_from_device
Failed to remove code from device.
failed_to_set_on_device
Failed to set code on device.
insufficient_permissions
Admin role required—insufficient permissions to manage PINs on this device. Please have an admin update your role, or ask them to set the PIN.
no_space_for_access_code_on_device
No space for access code on device.
provider_issue
Indicates a provider-specific issue that prevents the access code from being set or managed. Check the error message for details.
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.
Device
These errors are inherited from the Device resource. When they are set on the parent device, they are propagated to this resource’s errors list.
august_lock_not_authorized
Indicates that the user is not authorized to use the August lock.
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.
Warnings
Each warning is an object with the following shape:Example warning
Warning object properties
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.
Enum (String)
Indicates the type of external modification.
modified means the code’s PIN or schedule was changed. removed means the code was deleted from the device.Array
List of fields that were changed externally, with their previous and new values.
being_deleted
Access code is being deleted.
code_rotates_periodically
The access code’s PIN rotates periodically when the code is renewed. Retrieve the latest code before each use.
delay_in_removing_from_device
Delay in removing code from device.
delay_in_setting_on_device
Delay in setting code on device.
external_modification_in_effect
Code was modified or removed externally after Seam successfully set it on the device. External modification is allowed for this code, so the externally modified state is being honored.
igloo_algopin_must_be_used_within_24_hours
Algopins must be used within 24 hours.
management_transferred
Management was transferred to another workspace.
third_party_integration_detected
Third-party integration detected that may cause access codes to fail.
time_frame_adjusted_for_unknown_time_zone
The device’s time zone is unknown and this code’s time frame crosses a daylight-saving transition in at least one plausible time zone. A 1-hour safety buffer has been applied to the side of the time frame affected by the transition (ends_at for spring-forward, starts_at for fall-back) so the code stays active through the shift — the code may be usable up to 1 hour beyond your requested window. Set the device’s time zone via /devices/report_provider_metadata to clear the buffer and guarantee exact handling.