Skip to main content

​
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_bridge_error": true,
  "is_connected_account_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.
​
is_bridge_error
Boolean
Indicates whether the error is related to Seam Bridge.
​
is_connected_account_error
Boolean
Indicates whether the error is related specifically to the connected account.
​
salto_ks_metadata
Object
Salto KS metadata associated with the connected account that has an error.

​
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 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.

​
Warnings

Each warning is an object with the following shape:
Example warning
{
  "warning_code": "scheduled_maintenance_window",
  "message": "Indicates that scheduled downtime is planned for the connected account.",
  "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.
​
salto_ks_metadata
Object
Salto KS metadata associated with the connected account that has a warning.

​
account_reauthorization_requested

Indicates that the Connected Account requires reauthorization using a new Connect Webview. The account is still connected, but cannot access new features. Delaying reauthorization too long will eventually cause the Connected Account to become disconnected.

​
being_deleted

Indicates that the connected account is currently being deleted. All devices, access codes, and other resources associated with this account are in the process of being removed from Seam.

​
dormakaba_sites_unapproved

Indicates that one or more dormakaba sites associated with the connected account are not approved. Contact support@getseam.com to finish setting up your account.

​
provider_service_unavailable

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

​
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.

​
scheduled_maintenance_window

Indicates that scheduled downtime is planned for the connected account.

​
setup_required

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

​
unknown_issue_with_connected_account

Indicates that an unknown issue occurred while syncing the state of the connected account with the provider. This issue may affect the proper functioning of one or more resources in the account.