From 1eabd3c7bad1f7cd1b84415bbb517c4675aa8e90 Mon Sep 17 00:00:00 2001 From: tanya732 Date: Fri, 9 Jan 2026 13:40:01 +0530 Subject: [PATCH 1/3] Release 3.0.0 --- CHANGELOG.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 249367a6..cf60d5c3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,11 @@ # Change Log +## [3.0.0](https://github.com/auth0/auth0-java/tree/3.0.0) (2026-01-09) +[Full Changelog](https://github.com/auth0/auth0-java/compare/2.27.0...3.0.0) + +**Added** +- Adding v3 changes [\#790](https://github.com/auth0/auth0-java/pull/790) ([tanya732](https://github.com/tanya732)) + ## [3.0.0-beta.0](https://github.com/auth0/auth0-java/tree/3.0.0-beta.0) (2025-12-18) [Full Changelog](https://github.com/auth0/auth0-java/compare/2.27.0...3.0.0-beta.0) From b3a895bd9d0b55242e831e838bd821daa0e40c67 Mon Sep 17 00:00:00 2001 From: tanya732 Date: Fri, 9 Jan 2026 14:05:30 +0530 Subject: [PATCH 2/3] Updated .version and readme file --- .version | 2 +- README.md | 4 ++-- gradle.properties | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.version b/.version index 7e9b5249..4a36342f 100644 --- a/.version +++ b/.version @@ -1 +1 @@ -3.0.0-beta.0 +3.0.0 diff --git a/README.md b/README.md index 31af5a7e..5c6e7615 100644 --- a/README.md +++ b/README.md @@ -36,14 +36,14 @@ Add the dependency via Maven: com.auth0 auth0 - 3.0.0-beta.0 + 3.0.0 ``` or Gradle: ```gradle -implementation 'com.auth0:auth0:3.0.0-beta.0' +implementation 'com.auth0:auth0:3.0.0' ``` ### Configure the SDK diff --git a/gradle.properties b/gradle.properties index 9a6dd770..cb426bef 100644 --- a/gradle.properties +++ b/gradle.properties @@ -1,6 +1,6 @@ GROUP=com.auth0 POM_ARTIFACT_ID=auth0 -VERSION_NAME=3.0.0-beta.0 +VERSION_NAME=3.0.0 POM_NAME=auth0-java POM_DESCRIPTION=Java client library for the Auth0 platform From 3e9a05a2329ffc36ad8be544da78bf9e1355491b Mon Sep 17 00:00:00 2001 From: tanya732 Date: Fri, 9 Jan 2026 15:50:20 +0530 Subject: [PATCH 3/3] Updated changelog --- CHANGELOG.md | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 60 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index cf60d5c3..954aaab1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,8 +3,66 @@ ## [3.0.0](https://github.com/auth0/auth0-java/tree/3.0.0) (2026-01-09) [Full Changelog](https://github.com/auth0/auth0-java/compare/2.27.0...3.0.0) -**Added** -- Adding v3 changes [\#790](https://github.com/auth0/auth0-java/pull/790) ([tanya732](https://github.com/tanya732)) + +### Added Features + +- **New OpenAPI-generated Management API SDK**: Complete rewrite of the Management API client using Fern code generation. +- **Improved type safety**: using enums +- **Automatic pagination:** `SyncPagingIterable` for automatic pagination +- **Nullability annotations** on generated POJOs +- **error handling**: unified `ManagementApiException` class +- Support for **explicit null values** in **PATCH** operations +- **HTTP client** upgraded to **OkHttp 5.2.1** + +### ⚠️ Breaking Changes — Major Rewrite +- The Management API client has been fully rewritten using Fern OpenAPI code generation. Applications migrating from v2.x must update their code. +- **Key Breaking Changes**: + - Hierarchical sub-clients replace flat entity APIs. + - Manual pagination removed in favor of `SyncPagingIterable`. + - Unified exception handling via `ManagementApiException`. + - Client initialization updated to `ManagementApi.builder()`. + - Request and response models now use generated, immutable `*RequestContent`, `*ResponseContent`, and `*RequestParameters` types. + - Package structure updated across all Management API resources. + +### Deprecated APIs have been removed: +- Removed deprecated AuthAPI constructors. +- Removed legacy authentication and signup helpers. +- Deprecated networking helpers removed: +- Removed deprecated method from MultipartRequest. +- Removed internal EmptyBodyVoidRequest +- Removed HttpOptions +- Removed EXAMPLES.md, refer [reference.md](https://github.com/auth0/auth0-java/blob/master/reference.md) + + +### Migration Example + +#### Management API Client Initialization + +**Before (v2):** +```java +import com.auth0.client.mgmt.ManagementAPI; + +// Using domain and token +ManagementAPI mgmt = ManagementAPI.newBuilder("{YOUR_DOMAIN}", "{YOUR_API_TOKEN}").build(); + +// Using TokenProvider +TokenProvider tokenProvider = SimpleTokenProvider.create("{YOUR_API_TOKEN}"); +ManagementAPI mgmt = ManagementAPI.newBuilder("{YOUR_DOMAIN}", tokenProvider).build(); +``` + +**After (v3 – Standard Token-Based):** +```java +import com.auth0.client.mgmt.ManagementApi; + +ManagementApi client = ManagementApi + .builder() + .url("https://{YOUR_DOMAIN}/api/v2") + .token("{YOUR_API_TOKEN}") + .build(); +``` + +**Note**: The Authentication API remains supported, with deprecated APIs removed. +A complete migration guide is available at [MIGRATION_GUIDE](MIGRATION_GUIDE.md). ## [3.0.0-beta.0](https://github.com/auth0/auth0-java/tree/3.0.0-beta.0) (2025-12-18) [Full Changelog](https://github.com/auth0/auth0-java/compare/2.27.0...3.0.0-beta.0)