🚀 Auth0.ManagementApi v8 is now GA! 🚀

[kailash-b]

✨ What's Included

v8 is a major release that includes a completely redesigned, OpenAPI-generated SDK:

• 🔄 OpenAPI-Generated SDK: The Management API SDK is now generated from Auth0's OpenAPI specifications using Fern, ensuring the SDK stays up-to-date and consistent with the API.
• 🔑 Automatic Token Management: The new ManagementClient wrapper handles token acquisition and refresh automatically — no more manual token management.
• 🛡️ Improved Type Safety: All API operations use strongly typed request and response models for better compile-time safety.
• 📂 Better Organization: API operations are organized into logical hierarchical sub-clients for improved discoverability.
• ⚡ Enhanced Exception Handling: A unified exception hierarchy with specific exception types for different HTTP status codes.
• 📡 Raw HTTP Response Access: Access the raw HTTP response via the .WithRawResponse() method.
• 🏷️ Optional<T> Type: Distinguish between undefined and explicitly null values in PATCH operations.
• 📄 Async Pagination: Built-in support for pagination with async enumeration.
• 🧩 Comprehensive Interfaces: Full interfaces for all clients to simplify dependency injection and testing.

---

🔄 What Changed Since Beta

Since the beta announcement, we've made the following improvements based on feedback and continued development:

• 🔌 Custom Token Provider Support: Refactored token management to support pluggable token providers via DelegateTokenProvider, giving you full control over how tokens are acquired alongside the built-in ClientCredentialsTokenProvider.
• 🏗️ Simplified ManagementClient Internals: ManagementClient now inherits from the generated ManagementApiClient, removing redundant initialization and reducing wrapper complexity.
• 📋 Auth0-Client Telemetry Header: Added the Auth0-Client header via a ClientOptions.Internal partial class, ensuring proper SDK telemetry is sent with every request.
• 🧹 Dropped .NET 8 Compile-Time Requirement: Removed .NET 8 as a build-time dependency, simplifying the build toolchain while maintaining full runtime support.
• 🔃 Continuous API Sync: Multiple Fern-based regenerations to keep the SDK aligned with the latest Auth0 Management API changes.

---

📦 Installation

Install or upgrade via NuGet:

dotnet add package Auth0.ManagementApi --version 8.0.0

Or update your .csproj:

<PackageReference Include="Auth0.ManagementApi" Version="8.0.0" />

Supported Platforms

• .NET 8.0+
• .NET Framework 4.6.2+
• .NET Standard 2.0+

---

💥 Breaking Changes

This release contains 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 — your existing authentication code will continue to work as-is.

---

📖 Migration Guide

We have a comprehensive migration guide with side-by-side examples and detailed mappings from v7 to v8:

👉 V8_MIGRATION_GUIDE.md

---

⚠️ v7 Maintenance Policy

With v8 now GA, v7 will continue to receive security fixes only for a limited time. We strongly encourage all users to migrate to v8 at your earliest convenience. No new features will be added to v7.

---

🙏 Thank You

Thank you to everyone who tested the beta releases and provided feedback — your input was invaluable in shaping this release.

As always, we welcome your feedback. Please feel free to open an issue if you have any questions or suggestions.