Clerk Android API/com.clerk.api.auth.types/Strategy

Strategy

@Serializable(with = StrategySerializer::class)

sealed class Strategy

A typed authentication or verification strategy, such as email_code or oauth_google.

The Clerk API exchanges strategies as plain strings, and the SDK's models keep exposing those raw strings (for example com.clerk.api.network.model.factor.Factor.strategy). Use the typed accessors next to them (for example com.clerk.api.network.model.factor.Factor.strategyType) to compare strategies without string literals:

when (val strategy = factor.strategyType) {
  Strategy.EmailCode -> showEmailCodeInput()
  Strategy.Password -> showPasswordInput()
  is Strategy.OAuth -> showSocialButton(strategy.provider)
  else -> showGenericFactor()
}

Strategies the SDK does not know about decode to Unknown and keep their raw wire value, so a new server-side strategy never breaks decoding and round-trips unchanged. Two strategies are equal when their values are equal. Use Strategy.from to convert a raw string.

Inheritors

ResetPasswordEmailCode

ResetPasswordPhoneCode

Types

object BackupCode : Strategy

A single-use backup code.

object Companion

object EmailCode : Strategy

A one-time code sent by email.

object EmailLink : Strategy

A magic link sent by email.

object EnterpriseSso : Strategy

Enterprise SSO (SAML or OIDC) through an enterprise connection.

object GoogleOneTap : Strategy

A Google One Tap / Credential Manager ID token.

class OAuth : Strategy

A redirect-based OAuth strategy, oauth_<provider> (for example oauth_google or oauth_custom_acme).

class OAuthToken : Strategy

A native OAuth token exchange strategy, oauth_token_<provider>.

object Passkey : Strategy

A WebAuthn passkey.

object Password : Strategy

The user's password.

object PhoneCode : Strategy

A one-time code sent by SMS.

ResetPasswordEmailCode

object ResetPasswordEmailCode : Strategy

A password-reset code sent by email.

ResetPasswordPhoneCode

object ResetPasswordPhoneCode : Strategy

A password-reset code sent by SMS.

object Saml : Strategy

Legacy SAML SSO.

object Ticket : Strategy

A sign-in or sign-up ticket, such as an invitation or sign-in token.

object Totp : Strategy

A time-based one-time password from an authenticator app.

object Transfer : Strategy

A transfer between a sign-in and a sign-up attempt.

object TrustedDevice : Strategy

A biometric credential stored on this device.

class Unknown : Strategy

A strategy this version of the SDK does not recognize.

Properties

val value: String

The raw strategy string sent to and received from the Clerk API.

Functions

operator override fun equals(other: Any?): Boolean

override fun hashCode(): Int

override fun toString(): String

Returns the raw wire value, so a Strategy can be interpolated into requests and logs.