ErrorCode enum

A machine-readable identifier for an AuthApiException, returned by the Supabase Auth server as the error_code field.

Inheritance
Available extensions

Values

unexpectedFailure → const ErrorCode

An unexpected server failure, such as an internal error.

const ErrorCode('unexpected_failure')
validationFailed → const ErrorCode

A request value failed validation.

const ErrorCode('validation_failed')
badJson → const ErrorCode

The request body could not be parsed as JSON.

const ErrorCode('bad_json')
emailExists → const ErrorCode

The email address is already in use by another user.

const ErrorCode('email_exists')
emailAddressInvalid → const ErrorCode

The email address is not a valid address.

const ErrorCode('email_address_invalid')
phoneExists → const ErrorCode

The phone number is already in use by another user.

const ErrorCode('phone_exists')
badJwt → const ErrorCode

The provided JWT could not be parsed or verified.

const ErrorCode('bad_jwt')
notAdmin → const ErrorCode

The user does not have permission to perform an admin action.

const ErrorCode('not_admin')
noAuthorization → const ErrorCode

The request is missing a required Authorization header.

const ErrorCode('no_authorization')
userNotFound → const ErrorCode

No user matches the given identifier.

const ErrorCode('user_not_found')
sessionNotFound → const ErrorCode

The session does not exist or was already terminated.

const ErrorCode('session_not_found')
sessionExpired → const ErrorCode

The session has expired and must be refreshed.

const ErrorCode('session_expired')
refreshTokenNotFound → const ErrorCode

The refresh token does not exist, for example because it was revoked.

const ErrorCode('refresh_token_not_found')
refreshTokenAlreadyUsed → const ErrorCode

The refresh token was already exchanged for a new session.

const ErrorCode('refresh_token_already_used')
sessionMissing → const ErrorCode

The request requires a session but none was provided.

const ErrorCode('session_missing')
flowStateNotFound → const ErrorCode

The PKCE or OAuth flow state does not exist or already completed.

const ErrorCode('flow_state_not_found')
flowStateExpired → const ErrorCode

The PKCE or OAuth flow state has expired.

const ErrorCode('flow_state_expired')
signupDisabled → const ErrorCode

New user sign-ups are disabled for this project.

const ErrorCode('signup_disabled')
userBanned → const ErrorCode

The user has been banned and cannot sign in.

const ErrorCode('user_banned')
providerEmailNeedsVerification → const ErrorCode

The OAuth provider's email must be verified before it can be used.

const ErrorCode('provider_email_needs_verification')
inviteNotFound → const ErrorCode

The invite does not exist, was already used, or has expired.

const ErrorCode('invite_not_found')
badOauthState → const ErrorCode

The state parameter of the OAuth callback is missing or invalid.

const ErrorCode('bad_oauth_state')
badOauthCallback → const ErrorCode

The OAuth callback is missing required parameters.

const ErrorCode('bad_oauth_callback')
oauthProviderNotSupported → const ErrorCode

The OAuth provider is not enabled for this project.

const ErrorCode('oauth_provider_not_supported')
unexpectedAudience → const ErrorCode

The JWT's aud claim does not match what the server expects.

const ErrorCode('unexpected_audience')
singleIdentityNotDeletable → const ErrorCode

The user's only identity cannot be unlinked.

const ErrorCode('single_identity_not_deletable')
emailConflictIdentityNotDeletable → const ErrorCode

The identity cannot be unlinked because its email is used by another identity of the same user.

const ErrorCode('email_conflict_identity_not_deletable')
identityAlreadyExists → const ErrorCode

The identity is already linked to a user.

const ErrorCode('identity_already_exists')
emailProviderDisabled → const ErrorCode

Signing in with email is disabled for this project.

const ErrorCode('email_provider_disabled')
phoneProviderDisabled → const ErrorCode

Signing in with phone is disabled for this project.

const ErrorCode('phone_provider_disabled')
tooManyEnrolledMfaFactors → const ErrorCode

The user has reached the maximum number of enrolled MFA factors.

const ErrorCode('too_many_enrolled_mfa_factors')
mfaFactorNameConflict → const ErrorCode

An MFA factor with this name already exists for the user.

const ErrorCode('mfa_factor_name_conflict')
mfaFactorNotFound → const ErrorCode

No MFA factor matches the given identifier.

const ErrorCode('mfa_factor_not_found')
mfaIpAddressMismatch → const ErrorCode

The MFA challenge was created from a different IP address.

const ErrorCode('mfa_ip_address_mismatch')
mfaChallengeExpired → const ErrorCode

The MFA challenge has expired.

const ErrorCode('mfa_challenge_expired')
mfaVerificationFailed → const ErrorCode

The MFA verification code is incorrect.

const ErrorCode('mfa_verification_failed')
mfaVerificationRejected → const ErrorCode

The MFA verification was rejected, for example by an auth hook.

const ErrorCode('mfa_verification_rejected')
insufficientAal → const ErrorCode

The session's authenticator assurance level is too low for this operation.

const ErrorCode('insufficient_aal')
captchaFailed → const ErrorCode

The captcha verification failed.

const ErrorCode('captcha_failed')
samlProviderDisabled → const ErrorCode

SAML SSO is disabled for this project.

const ErrorCode('saml_provider_disabled')
manualLinkingDisabled → const ErrorCode

Manually linking identities is disabled for this project.

const ErrorCode('manual_linking_disabled')
smsSendFailed → const ErrorCode

The SMS message could not be sent.

const ErrorCode('sms_send_failed')
emailNotConfirmed → const ErrorCode

The user's email has not been confirmed yet.

const ErrorCode('email_not_confirmed')
phoneNotConfirmed → const ErrorCode

The user's phone number has not been confirmed yet.

const ErrorCode('phone_not_confirmed')
reauthNonceMissing → const ErrorCode

The reauthentication nonce is missing from the request.

const ErrorCode('reauth_nonce_missing')
samlRelayStateNotFound → const ErrorCode

The SAML relay state does not exist or was already used.

const ErrorCode('saml_relay_state_not_found')
samlRelayStateExpired → const ErrorCode

The SAML relay state has expired.

const ErrorCode('saml_relay_state_expired')
samlIdpNotFound → const ErrorCode

No SAML identity provider matches the given identifier.

const ErrorCode('saml_idp_not_found')
samlAssertionNoUserId → const ErrorCode

The SAML assertion did not contain a user identifier.

const ErrorCode('saml_assertion_no_user_id')
samlAssertionNoEmail → const ErrorCode

The SAML assertion did not contain an email address.

const ErrorCode('saml_assertion_no_email')
userAlreadyExists → const ErrorCode

A user with this identifier already exists.

const ErrorCode('user_already_exists')
ssoProviderNotFound → const ErrorCode

No SSO provider matches the given identifier.

const ErrorCode('sso_provider_not_found')
samlMetadataFetchFailed → const ErrorCode

The SAML identity provider's metadata could not be fetched.

const ErrorCode('saml_metadata_fetch_failed')
samlIdpAlreadyExists → const ErrorCode

A SAML identity provider with this entity ID already exists.

const ErrorCode('saml_idp_already_exists')
ssoDomainAlreadyExists → const ErrorCode

The SSO domain is already registered to a provider.

const ErrorCode('sso_domain_already_exists')
samlEntityIdMismatch → const ErrorCode

The SAML assertion's entity ID does not match the registered provider.

const ErrorCode('saml_entity_id_mismatch')
conflict → const ErrorCode

The request conflicts with the current state of the resource, for example a concurrent update.

const ErrorCode('conflict')
providerDisabled → const ErrorCode

The authentication provider is disabled for this project.

const ErrorCode('provider_disabled')
userSsoManaged → const ErrorCode

The user's account is managed by SSO and cannot be modified directly.

const ErrorCode('user_sso_managed')
reauthenticationNeeded → const ErrorCode

The operation requires the user to reauthenticate first.

const ErrorCode('reauthentication_needed')
samePassword → const ErrorCode

The new password must be different from the current one.

const ErrorCode('same_password')
reauthenticationNotValid → const ErrorCode

The reauthentication code is incorrect or expired.

const ErrorCode('reauthentication_not_valid')
otpExpired → const ErrorCode

The one-time password has expired.

const ErrorCode('otp_expired')
otpDisabled → const ErrorCode

Signing in with a one-time password is disabled for this project.

const ErrorCode('otp_disabled')
identityNotFound → const ErrorCode

No identity matches the given identifier.

const ErrorCode('identity_not_found')
weakPassword → const ErrorCode

The password does not meet the project's strength requirements.

const ErrorCode('weak_password')
overRequestRateLimit → const ErrorCode

Too many requests were sent in a short period.

const ErrorCode('over_request_rate_limit')
overEmailSendRateLimit → const ErrorCode

Too many emails were sent to this address in a short period.

const ErrorCode('over_email_send_rate_limit')
overSmsSendRateLimit → const ErrorCode

Too many SMS messages were sent to this number in a short period.

const ErrorCode('over_sms_send_rate_limit')
badCodeVerifier → const ErrorCode

The PKCE code verifier does not match the code challenge sent when the flow started.

const ErrorCode('bad_code_verifier')
anonymousProviderDisabled → const ErrorCode

Signing in anonymously is disabled for this project.

const ErrorCode('anonymous_provider_disabled')
hookTimeout → const ErrorCode

An auth hook did not respond in time.

const ErrorCode('hook_timeout')
hookTimeoutAfterRetry → const ErrorCode

An auth hook did not respond in time even after being retried.

const ErrorCode('hook_timeout_after_retry')
hookPayloadOverSizeLimit → const ErrorCode

An auth hook's response exceeded the maximum payload size.

const ErrorCode('hook_payload_over_size_limit')
hookPayloadUnknownSize → const ErrorCode

An auth hook's response did not report its payload size.

const ErrorCode('hook_payload_unknown_size')
requestTimeout → const ErrorCode

The request took too long to complete.

const ErrorCode('request_timeout')
mfaPhoneEnrollDisabled → const ErrorCode

Enrolling a phone MFA factor is disabled for this project.

const ErrorCode('mfa_phone_enroll_not_enabled')
mfaPhoneVerifyDisabled → const ErrorCode

Verifying a phone MFA factor is disabled for this project.

const ErrorCode('mfa_phone_verify_not_enabled')
mfaTotpEnrollDisabled → const ErrorCode

Enrolling a TOTP MFA factor is disabled for this project.

const ErrorCode('mfa_totp_enroll_not_enabled')
mfaTotpVerifyDisabled → const ErrorCode

Verifying a TOTP MFA factor is disabled for this project.

const ErrorCode('mfa_totp_verify_not_enabled')
mfaWebauthnEnrollDisabled → const ErrorCode

Enrolling a WebAuthn MFA factor is disabled for this project.

const ErrorCode('mfa_webauthn_enroll_not_enabled')
mfaWebauthnVerifyDisabled → const ErrorCode

Verifying a WebAuthn MFA factor is disabled for this project.

const ErrorCode('mfa_webauthn_verify_not_enabled')
mfaRecoveryCodesEnrollDisabled → const ErrorCode

Generating MFA recovery codes is disabled for this project.

const ErrorCode('mfa_recovery_codes_enroll_not_enabled')
mfaRecoveryCodesVerifyDisabled → const ErrorCode

Verifying MFA recovery codes is disabled for this project.

const ErrorCode('mfa_recovery_codes_verify_not_enabled')
mfaRecoveryCodesLocked → const ErrorCode

Recovery code verification is temporarily locked after too many failed attempts.

const ErrorCode('mfa_recovery_codes_locked')
mfaRecoveryCodesSoleFactor → const ErrorCode

Recovery codes cannot be the user's only MFA factor.

const ErrorCode('mfa_recovery_codes_sole_factor')
mfaVerifiedFactorExists → const ErrorCode

The user already has a verified factor of this type.

const ErrorCode('mfa_verified_factor_exists')
passkeyDisabled → const ErrorCode

Passkeys are disabled for this project.

const ErrorCode('passkey_disabled')
tooManyPasskeys → const ErrorCode

The user has reached the maximum number of registered passkeys.

const ErrorCode('too_many_passkeys')
webauthnChallengeNotFound → const ErrorCode

The WebAuthn challenge does not exist or was already used.

const ErrorCode('webauthn_challenge_not_found')
webauthnChallengeExpired → const ErrorCode

The WebAuthn challenge has expired.

const ErrorCode('webauthn_challenge_expired')
webauthnCredentialExists → const ErrorCode

The WebAuthn credential is already registered.

const ErrorCode('webauthn_credential_exists')
webauthnCredentialNotFound → const ErrorCode

No WebAuthn credential matches the given identifier.

const ErrorCode('webauthn_credential_not_found')
webauthnVerificationFailed → const ErrorCode

The WebAuthn verification failed.

const ErrorCode('webauthn_verification_failed')

Properties

code → String
The wire value sent as the error_code field.
final
hashCode → int
The hash code for this object.
no setterinherited
index → int
A numeric identifier for the enumerated value.
no setterinherited
name → String

Available on Enum, provided by the EnumName extension

The name of the enum value.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Methods

fromCode(String code) → ErrorCode?
Returns the error code whose code matches, or null if none does.

Constants

values → const List<ErrorCode>
A constant List of the values in this enum, in order of their declaration.