Release 6.0.0.beta.0

[kishore7snehil]

This is a beta release. It introduces breaking changes to the Management API. The Authentication API is unchanged. Please consult the v6 Migration Guide for detailed upgrade instructions.

What's New

This release marks a major milestone for the Auth0 Ruby SDK: the Management API client has been completely rewritten using the Fern code generation tool, built directly from the Auth0 OpenAPI specification. This delivers complete, always-up-to-date API coverage with full type safety.

Highlights

• Auto-generated Management API - Rebuilt from the Auth0 OpenAPI spec using Fern, ensuring complete endpoint coverage and consistency with the API
• Strongly-typed responses - API methods return typed response objects with accessor methods instead of raw hashes
• Built-in pagination - List methods return iterators that automatically fetch pages as you iterate with each
• Automatic token management - Auth0::Client handles OAuth 2.0 client credentials grant and token refresh out of the box
• Built-in retry - Automatic retries with exponential backoff for rate-limited (429) responses
• Exception-driven error handling - Non-2xx responses raise typed exceptions (Auth0::Errors::NotFoundError, etc.) instead of returning error hashes

What's Changed

The Authentication API is ported from v5 with identical interface. Login, signup, token exchange, passwordless, and MFA flows all work the same way.

The Management API has breaking changes:

Area	v5	v6
Client	Auth0Client.new(...)	Auth0::Client.new(domain:, client_id:, client_secret:)
Sub-client access	client.users(...)	client.users.list(...)
Responses	Raw hashes / arrays	Typed objects (user.email, user.user_id)
Pagination	Manual page param	client.users.list.each { |u| ... }
Error handling	Check response hash	rescue Auth0::Errors::NotFoundError
HTTP client	rest-client	net/http (internal)

Installation

# Gemfile
gem "auth0", "6.0.0.beta.0"

or

gem install auth0 --pre

Running gem install auth0 without --pre will install the latest stable v5 release.

Quick Start

require "auth0"

client = Auth0::Client.new(
  domain: "tenant.auth0.com",
  client_id: "CLIENT_ID",
  client_secret: "CLIENT_SECRET"
)

# List users with automatic pagination
client.users.list(per_page: 50, include_totals: true).each do |user|
  puts user.email
end

Resources

• v6 Migration Guide (v5 → v6)
• Examples
• API Reference

Breaking Changes

• Management API client rewritten using Fern code generation
• Auth0Client replaced by Auth0::Client
• Management API methods accessed via namespaced sub-clients
• API methods return typed response objects instead of hashes
• List methods return paginated iterators instead of arrays
• Non-2xx responses raise typed exceptions automatically
• rest-client dependency removed; uses net/http internally
• Minimum Ruby version raised to 3.3

Feedback

This is a beta release - we would love your feedback! Please open an issue if you encounter any problems or have suggestions.

[arpit-jn]

LGTM