Skip to main content

Errors

Each error is an object with the following shape:
Example error
{
  "error_code": "provider_issue",
  "message": "Indicates a provider-specific issue that prevents the access code from being set or managed. Check the error message for details.",
  "created_at": "2025-01-01T00:00:00.000Z",
  "is_access_code_error": true
}
error_code
Enum (String)
Unique identifier of the type of error. Enables quick recognition and categorization of the issue.One of the error codes listed below.
message
String
Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
created_at
String (ISO 8601)
Date and time at which Seam created the error.
change_type
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.
is_access_code_error
Boolean
Indicates that this is an access code error.
is_bridge_error
Boolean
Indicates whether the error is related to Seam Bridge.
is_connected_account_error
Boolean
Indicates that the error is a connected account error.
is_device_error
Boolean
Indicates that the error is not a device error.
managed_access_code_id
String (UUID)
ID of the managed access code that conflicts with this managed access code, when Seam can identify it.
modified_fields
Array
List of fields that were changed externally, with their previous and new values.
unmanaged_access_code_id
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.

code_modified_external_to_seam

Code was modified or removed externally after Seam successfully set it on the device.

duplicate_code_attempt_prevented

An attempt to modify this access code was prevented.

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_missing_bridge

Indicates that the lock is not connected to a bridge.

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.

lockly_missing_wifi_bridge

Indicates that the Lockly lock is not connected to a Wi-Fi bridge.

missing_device_credentials

Indicates that device credentials are missing.

subscription_required

Indicates that a subscription is required to connect.

ttlock_lock_not_paired_to_gateway

Indicates that the lock is not paired with a gateway.

Warnings

Each warning is an object with the following shape:
Example warning
{
  "warning_code": "code_rotates_periodically",
  "message": "The access code's PIN rotates periodically when the code is renewed. Retrieve the latest code before each use.",
  "created_at": "2025-01-01T00:00:00.000Z"
}
warning_code
Enum (String)
Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.One of the warning codes listed below.
message
String
Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
created_at
String (ISO 8601)
Date and time at which Seam created the warning.
change_type
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.
modified_fields
Array
List of fields that were changed externally, with their previous and new values.

being_deleted

Access code is being deleted.

code_modified_external_to_seam

Code was modified or removed externally after Seam successfully set it on the device.

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.

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.

using_backup_access_code

A backup access code has been pulled and is being used in place of this access code.