MFA & Passkeys API Reference

func getUserDevices() async throws -> [MfaDevice]

let sdk = DynamicSDK.instance()
let devices = try await sdk.mfa.getUserDevices()

func addDevice(type: String) async throws -> MfaAddDevice

let sdk = DynamicSDK.instance()
let result = try await sdk.mfa.addDevice(type: "totp")
print("Secret: \(result.secret)")

func verifyDevice(_ code: String, type: String) async throws

let sdk = DynamicSDK.instance()
try await sdk.mfa.verifyDevice("123456", type: "totp")

func authenticateDevice(params: MfaAuthenticateDevice) async throws -> String?

let sdk = DynamicSDK.instance()
let mfaToken = try await sdk.mfa.authenticateDevice(
    params: MfaAuthenticateDevice(
        code: "123456",
        deviceId: "device_id",
        createMfaToken: MfaCreateToken(singleUse: false)
    )
)

func deleteUserDevice(deviceId: String, mfaAuthToken: String) async throws

let sdk = DynamicSDK.instance()
try await sdk.mfa.deleteUserDevice(
    deviceId: "device_id",
    mfaAuthToken: mfaToken
)

func getRecoveryCodes(generateNewCodes: Bool) async throws -> [String]

let sdk = DynamicSDK.instance()
let codes = try await sdk.mfa.getRecoveryCodes(generateNewCodes: false)

func getNewRecoveryCodes() async throws -> [String]

let sdk = DynamicSDK.instance()
let newCodes = try await sdk.mfa.getNewRecoveryCodes()

// User must acknowledge the new codes
try await sdk.mfa.completeAcknowledgement()

func isPendingRecoveryCodesAcknowledgment() async throws -> Bool

let sdk = DynamicSDK.instance()
let isPending = try await sdk.mfa.isPendingRecoveryCodesAcknowledgment()

func completeAcknowledgement() async throws

let sdk = DynamicSDK.instance()
try await sdk.mfa.completeAcknowledgement()

func authenticateRecoveryCode(code: MfaAuthenticateRecoveryCode) async throws -> String?

let sdk = DynamicSDK.instance()
let mfaToken = try await sdk.mfa.authenticateRecoveryCode(
    code: MfaAuthenticateRecoveryCode(
        code: "recovery_code",
        createMfaToken: MfaCreateToken(singleUse: true)
    )
)

func signIn() async throws -> SdkUser

let sdk = DynamicSDK.instance()
let user = try await sdk.auth.passkey.signIn()

func registerPasskey() async throws -> PasskeyRegistrationResult

let sdk = DynamicSDK.instance()
_ = try await sdk.passkeys.registerPasskey()

func getPasskeys() async throws -> [UserPasskey]

let sdk = DynamicSDK.instance()
let passkeys = try await sdk.passkeys.getPasskeys()

func authenticatePasskeyMFA(
    createMfaToken: MfaCreateToken,
    relatedOriginRpId: String?
) async throws -> PasskeyMfaResponse

let sdk = DynamicSDK.instance()
let response = try await sdk.passkeys.authenticatePasskeyMFA(
    createMfaToken: MfaCreateToken(singleUse: true),
    relatedOriginRpId: nil
)
print("Token: \(response.jwt ?? "nil")")

func deletePasskey(_ request: DeletePasskeyRequest) async throws

let sdk = DynamicSDK.instance()
try await sdk.passkeys.deletePasskey(
    DeletePasskeyRequest(passkeyId: "passkey_id")
)

struct MfaDevice {
    let id: String?
    let type: MfaDeviceType?
    let createdAt: String?
}

struct MfaAddDevice {
    let secret: String
}

struct MfaAuthenticateDevice {
    let code: String
    let deviceId: String
    let createMfaToken: MfaCreateToken
}

struct MfaCreateToken {
    let singleUse: Bool
}

struct MfaAuthenticateRecoveryCode {
    let code: String
    let createMfaToken: MfaCreateToken
}

struct UserPasskey {
    let id: String
    let createdAt: Date
    let lastUsedAt: Date?
    let isDefault: Bool?
}

struct DeletePasskeyRequest {
    let passkeyId: String
}

struct PasskeyMfaResponse {
    let jwt: String?
}

let sdk = DynamicSDK.instance()

do {
    let devices = try await sdk.mfa.getUserDevices()
} catch {
    print("Error: \(error.localizedDescription)")
}