Skip to main content
The Web SDK methods can return the following fields when encountering an error.
string
A code which identifies a specific error state. This value can be used to drive application logic such as when a user encounters a rate limit error.
string
A description of the error. This value should only be used for logging or troubleshooting purposes.

Error codes

Indicates that an error occurred when making a network request to the Authsignal API. This will occur if the device has no network connection.
Indicates that the Authsignal token has expired. This will occur if more than 10 minutes has elapsed since it was generated by tracking an action or since a previous challenge was completed.
Indicates that the credential (e.g. passkey) being used for verification is invalid. This may occur if the credential has been removed from the server but still exists on the user’s credential manager.
Indicates that the passkey credential presented during sign-in is not recognized by the server. This can occur if the credential was deleted from the server but still exists in the user’s credential manager. When credential syncing is enabled, the SDK signals the browser to remove the stale credential so it is no longer offered.
Indicates that no immediately available passkey credential was found when signing in with preferImmediatelyAvailableCredentials set to true. Fall back to a standard passkey sign-in or an alternative authentication method.
Indicates that the current browser does not support immediate mediation UI mode, which is required when signing in with preferImmediatelyAvailableCredentials set to true.
Indicates that no token has been set before calling a method that requires one. Track an action to obtain a token, then call setToken before retrying.
Indicates that the server cannot respond as requests have been rate-limited due to exceeding a threshold. For example, a user has requested too many OTP codes in a short period of time.