Skip to main content

​
Errors

Each error is an object with the following shape:
Example error
{
  "error_code": "seam_bridge_disconnected",
  "message": "Indicates that the Seam API cannot communicate with Seam Bridge, for example, if Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline.\n  This error might also occur if Seam Bridge is connected to the wrong workspace.\n  See also Troubleshooting Your Access Control System.",
  "created_at": "2025-01-01T00:00:00.000Z"
}
​
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.
​
is_bridge_error
Boolean
Indicates whether the error is related to the Seam Bridge.

​
account_disconnected

Indicates that the login credentials are invalid. Reconnect the account using a Connect Webview to restore access.

​
acs_system_disconnected

Indicates that the access control system has been disconnected. See Troubleshooting Your Access Control System to resolve the issue.

​
bridge_disconnected

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

​
provider_service_unavailable

Indicates that the access control system provider’s service is temporarily unavailable. Seam will automatically retry and reconnect when the service becomes available again.

​
salto_ks_certification_expired

Indicates that the access control system has lost its Salto KS certification. Contact support to regain access.

​
salto_ks_subscription_limit_exceeded

Indicates that the maximum number of users allowed for the site has been reached. This means that new access codes cannot be created. Contact Salto support to increase the user limit.

​
seam_bridge_disconnected

Indicates that the Seam API cannot communicate with Seam Bridge, for example, if Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline. This error might also occur if Seam Bridge is connected to the wrong workspace. See also Troubleshooting Your Access Control System.

​
visionline_instance_unreachable

Indicates that Seam Bridge is functioning correctly and the Seam API can communicate with Seam Bridge, but the Seam API cannot connect to the on-premises Visionline access control system. For example, the IP address of the on-premises access control system may be set incorrectly within the Seam workspace. See also Troubleshooting Your Access Control System.

​
Warnings

Each warning is an object with the following shape:
Example warning
{
  "warning_code": "salto_ks_subscription_limit_almost_reached",
  "message": "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 to rectify the issue.",
  "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.
​
misconfigured_acs_entrance_ids
Array
The misconfigured acs entrance ids.

​
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 to rectify the issue.

​
setup_required

Indicates that the access control system requires additional setup before it can be fully operational. Follow the instructions in the warning message to complete the setup.

​
time_zone_does_not_match_location

Indicates the access control system time zone could not be determined because the reported physical location does not match the time zone configured on the physical ACS entrances.