From 7927fce5a08999d02b98588d0433a1a49b8224e1 Mon Sep 17 00:00:00 2001 From: utkrishtS Date: Thu, 25 Jun 2026 12:26:47 +0530 Subject: [PATCH 1/2] docs: add deprecation notice for UsersAPIClient in Management API example --- EXAMPLES.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/EXAMPLES.md b/EXAMPLES.md index 1520f3cf..ec283900 100644 --- a/EXAMPLES.md +++ b/EXAMPLES.md @@ -3221,6 +3221,8 @@ params.put("screen_hint", "signup"); The client provides a few methods to interact with the [Users Management API](https://auth0.com/docs/api/management/v2/#!/Users). +> ⚠️ **Deprecated** — `UsersAPIClient` is deprecated and will be removed in the next major version of the SDK. See the [CHANGELOG](CHANGELOG.md) for migration guidance. + Create a new instance passing the account and an access token with the Management API audience and the right scope: ```kotlin From 413a957873898d12a72f8ad86e811e5a5fcbc76f Mon Sep 17 00:00:00 2001 From: Sanchit Mehta Date: Thu, 25 Jun 2026 13:04:14 +0530 Subject: [PATCH 2/2] docs: fix deprecation callouts for loginWithOTP and UsersAPIClient MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add proper ⚠️ callout at the top of the MFA with OTP section naming the replacement (MfaApiClient) and linking to the new section; remove the old plain-text "> Note" that appeared after all the examples - Trim UsersAPIClient callout: remove the "See the CHANGELOG for migration guidance" line (no actionable replacement exists; the CHANGELOG link added noise without useful guidance) --- EXAMPLES.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/EXAMPLES.md b/EXAMPLES.md index ec283900..10fac0d3 100644 --- a/EXAMPLES.md +++ b/EXAMPLES.md @@ -457,6 +457,8 @@ authentication ### Login using MFA with One Time Password code +> ⚠️ **Deprecated** — `loginWithOTP`, `loginWithOOB`, `loginWithRecoveryCode`, and `multifactorChallenge` are deprecated and will be removed in the next major version. Use `MfaApiClient` instead — see the [MFA Flexible Factors Grant](#mfa-flexible-factors-grant) section below. + This call requires the client to have the *MFA* Client Grant Type enabled. Check [this article](https://auth0.com/docs/clients/client-grant-types) to learn how to enable it. When you sign in to a multifactor authentication enabled connection using the `login` method, you receive an error standing that MFA is required for that user along with an `mfa_token` value. Use this value to call `loginWithOTP` and complete the MFA flow passing the One Time Password from the enrolled MFA code generator app. @@ -511,8 +513,6 @@ authentication > The default scope used is `openid profile email`. Regardless of the scopes set to the request, the `openid` scope is always enforced. -> **Note** : The MFA APIs in Authentication client has been deprecated. Use the new MFA Flexible Factors APIs - ### MFA Flexible Factors Grant > [!IMPORTANT] @@ -3221,7 +3221,7 @@ params.put("screen_hint", "signup"); The client provides a few methods to interact with the [Users Management API](https://auth0.com/docs/api/management/v2/#!/Users). -> ⚠️ **Deprecated** — `UsersAPIClient` is deprecated and will be removed in the next major version of the SDK. See the [CHANGELOG](CHANGELOG.md) for migration guidance. +> ⚠️ **Deprecated** — `UsersAPIClient` will be removed in the next major version. Create a new instance passing the account and an access token with the Management API audience and the right scope: