From 4bb96d0337a4cda60f39a4d88c5a56a982c43636 Mon Sep 17 00:00:00 2001 From: Snehil Kishore Date: Thu, 13 Aug 2026 13:10:20 +0530 Subject: [PATCH 1/3] Release 6.0.0 --- .version | 2 +- CHANGELOG.md | 30 ++++++++++++++++++++++++++++++ lib/auth0/version.rb | 2 +- 3 files changed, 32 insertions(+), 2 deletions(-) diff --git a/.version b/.version index 5c77d55e0..9773998bc 100644 --- a/.version +++ b/.version @@ -1 +1 @@ -v6.0.0.beta.5 +v6.0.0 diff --git a/CHANGELOG.md b/CHANGELOG.md index b8535646d..4f23e6f0e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,35 @@ # Change Log +## [v6.0.0](https://github.com/auth0/ruby-auth0/tree/v6.0.0) (2026-08-13) +[Full Changelog](https://github.com/auth0/ruby-auth0/compare/v5.20.0...v6.0.0) + +Note: As this is a major release it is recommended to understand the **Breaking Changes** section before upgrading. The [v6 Migration Guide](v6_MIGRATION_GUIDE.md) contains detailed upgrade instructions. + +v6.0.0 is the first stable release of the v6 line. The Management API client is now generated from Auth0's OpenAPI specification via [Fern](https://buildwithfern.com/), with strongly-typed requests and responses, built-in pagination, and automatic token management through the unified `Auth0::Client`. The Authentication API is ported from v5 and maintains full feature parity. + +**Breaking Changes** +- Management API client rewritten using Fern code generation +- `Auth0Client` replaced by `Auth0::Client` (unified client for Authentication + Management APIs; `Auth0Client` remains as a backward-compatible alias) +- Management API methods accessed via namespaced sub-clients (`client.users.list` instead of `client.users`) +- Method names follow a consistent pattern (`list`, `create`, `get`, `update`, `delete`), and sub-resource operations moved to dedicated sub-clients +- All Management API methods use keyword arguments instead of positional parameters +- API methods return strongly-typed response objects instead of raw hashes +- List methods return paginated iterators instead of arrays +- Non-2xx responses raise typed exceptions (`Auth0::Errors::NotFoundError`, etc.) instead of returning error hashes +- The `api_version` parameter has been removed (v6 supports Management API v2 only) +- `rest-client` dependency removed; uses `net/http` internally +- Minimum Ruby version raised to 3.3 + +**Added** +- Auto-generated Management API with complete endpoint coverage from Auth0's OpenAPI spec +- Automatic OAuth 2.0 client credentials token management, with a new `token_provider` option for supplying tokens from an external source +- Built-in retry with exponential backoff for transient failures (408, 429, 5xx) +- Automatic pagination through iterator objects for all list endpoints +- `v6_MIGRATION_GUIDE.md` for upgrading from v5 + +**Unchanged** +- Authentication API (login, signup, token exchange, passwordless, MFA) + ## [v6.0.0.beta.5](https://github.com/auth0/ruby-auth0/tree/v6.0.0.beta.5) (2026-08-05) [Full Changelog](https://github.com/auth0/ruby-auth0/compare/v6.0.0.beta.4...v6.0.0.beta.5) diff --git a/lib/auth0/version.rb b/lib/auth0/version.rb index 364705d51..29b2103ba 100644 --- a/lib/auth0/version.rb +++ b/lib/auth0/version.rb @@ -1,5 +1,5 @@ # frozen_string_literal: true module Auth0 - VERSION = "6.0.0.beta.5" + VERSION = "6.0.0" end From 428f632bfebe405a99710f14016320628bb7229b Mon Sep 17 00:00:00 2001 From: Snehil Kishore Date: Thu, 13 Aug 2026 13:16:19 +0530 Subject: [PATCH 2/3] Sync Gemfile.lock to 6.0.0 --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index a2c19e73f..b443713fa 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,7 +1,7 @@ PATH remote: . specs: - auth0 (6.0.0.beta.5) + auth0 (6.0.0) addressable (~> 2.8) jwt (>= 2.7, < 4.0) rest-client (~> 2.1) From 90432dac1a42ba01af3faadaedabb19fcee610be Mon Sep 17 00:00:00 2001 From: Snehil Kishore Date: Thu, 13 Aug 2026 13:24:47 +0530 Subject: [PATCH 3/3] Sync ruby-api example Gemfile.lock to 6.0.0 --- examples/ruby-api/Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/examples/ruby-api/Gemfile.lock b/examples/ruby-api/Gemfile.lock index 3cbd35632..61a18f880 100644 --- a/examples/ruby-api/Gemfile.lock +++ b/examples/ruby-api/Gemfile.lock @@ -1,7 +1,7 @@ PATH remote: ../.. specs: - auth0 (6.0.0.beta.5) + auth0 (6.0.0) addressable (~> 2.8) jwt (>= 2.7, < 4.0) rest-client (~> 2.1)