release mgmt-8.0.0-beta.0

[kailash-b]

8.0.0-beta.0 (2026-02-04)

Full Changelog

This is a major version update that represents a complete modernization of the Management API SDK architecture and developer experience.

What's New:

• OpenAPI-Generated SDK: The Management API SDK is now generated from Auth0's OpenAPI specifications using Fern, ensuring consistency, accuracy, and easier maintenance going forward.
• Automatic Token Management: Introduced a new ManagementClient wrapper that handles token acquisition and refresh automatically using client credentials, eliminating the need for manual token management.
• Improved Type Safety: All API operations now use strongly typed request and response models with proper validation and clear naming conventions (*RequestContent, *ResponseContent, *RequestParameters).
• Better Organization: API operations are now organized into logical hierarchical sub-clients (e.g., client.Users.Permissions, client.Users.Roles, client.Organizations.Members) for better discoverability and cleaner code.
• Enhanced Exception Handling: Unified exception hierarchy based on ManagementApiException with specific exception types for different HTTP status codes (NotFoundError, BadRequestError, TooManyRequestsError, etc.).
• New Features:
  • Raw response access via .WithRawResponse() for accessing status codes, headers, and other HTTP metadata
  • Optional<T> type for distinguishing between undefined and explicitly null values in PATCH operations
  • Built-in pagination support with async enumeration
  • Comprehensive interfaces for dependency injection and testing

Breaking Changes:

This is a major version with breaking changes to client initialization, request/response types, method signatures, and exception handling. All existing v7 Management API code will require updates to work with v8. The Authentication API (Auth0.AuthenticationApi) remains unchanged and fully compatible.

Migration Guide:

Please refer to the comprehensive migration guide at V8_MIGRATION_GUIDE.md which includes side-by-side examples and detailed mappings from v7 to v8.

Changed

• Adds v8 for ManagementApi #911 (kailash-b)