Release mgmt-8.0.0

[kailash-b]

8.0.0 (2026-04-02)

Full Changelog

v8 is a major release of Auth0.ManagementApi featuring a completely redesigned, OpenAPI-generated SDK. The Authentication API (Auth0.AuthenticationApi) remains unchanged.

For a comprehensive migration guide with side-by-side examples, see V8_MIGRATION_GUIDE.md.

Added

• OpenAPI-generated Management API SDK using Fern, ensuring the SDK stays up-to-date and consistent with the Auth0 Management API #964 (kailash-b)
• Automatic token management via ManagementClient wrapper with built-in ClientCredentialsTokenProvider for token acquisition and refresh #964 (kailash-b)
• Custom token provider support via pluggable ITokenProvider interface, including DelegateTokenProvider for async token retrieval #926 (kailash-b)
• Strongly typed request and response models (*RequestContent, *ResponseContent, *RequestParameters) for all API operations #964 (kailash-b)
• Hierarchical sub-client organization for improved discoverability (e.g., client.Users.Roles.ListAsync(), client.Users.Permissions.ListAsync()) #964 (kailash-b)
• Unified exception hierarchy with specific exception types per HTTP status code (BadRequestError, NotFoundError, TooManyRequestsError, etc.) #964 (kailash-b)
• Raw HTTP response access via .WithRawResponse() method for status codes, headers, and URL metadata #964 (kailash-b)
• Optional<T> type to distinguish between undefined and explicitly null values in PATCH operations #964 (kailash-b)
• Async pagination support via Pager<T> with IAsyncEnumerable<T> for automatic multi-page iteration #964 (kailash-b)
• Comprehensive interfaces (IManagementApiClient, IUsersClient, etc.) for all clients to simplify dependency injection and testing #964 (kailash-b)
• Per-request configuration via RequestOptions (timeout, retries, custom headers) #964 (kailash-b)
• Auth0-Client telemetry header via ClientOptions.Internal partial class #964 (kailash-b)

Changed

• Serialization library changed from Newtonsoft.Json to System.Text.Json for Auth0.ManagementApi #964 (kailash-b)
• ManagementClient now inherits from the generated ManagementApiClient, simplifying internals #964 (kailash-b)
• Client initialization redesigned — use ManagementClient with ManagementClientOptions or ManagementApiClient with a pre-obtained token #964 (kailash-b)
• Request types renamed from *CreateRequest/*UpdateRequest to *RequestContent naming convention #964 (kailash-b)
• Response types renamed from domain objects (e.g., User) to *ResponseContent naming convention #964 (kailash-b)
• Pagination changed from IPagedList<T> with PaginationInfo to Pager<T> with built-in parameters #964 (kailash-b)
• Exception handling changed from ErrorApiException/RateLimitApiException to typed exceptions (NotFoundError, TooManyRequestsError, etc.) #964 (kailash-b)
• Namespace imports changed from Auth0.ManagementApi.Models to Auth0.ManagementApi and Auth0.ManagementApi.Core #964 (kailash-b)
• Dropped .NET 8 as a build-time dependency while maintaining full runtime support #927 (kailash-b)

Breaking Changes

This release contains breaking changes to client initialization, request/response types, method signatures, serialization, and exception handling. All existing v7 Management API code will require updates to work with v8. See the V8 Migration Guide for detailed upgrade instructions.

Supported Platforms

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

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 34.67%. Comparing base (2e2c8fb) to head (d9ae7d3).
⚠️ Report is 2 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #968   +/-   ##
=======================================
  Coverage   34.67%   34.67%           
=======================================
  Files        2341     2341           
  Lines       92795    92795           
  Branches     5383     5383           
=======================================
  Hits        32178    32178           
  Misses      58923    58923           
  Partials     1694     1694           

Flag	Coverage Δ
authIntTests	3.26% <ø> (ø)
mgmtIntTests	33.29% <ø> (ø)
unittests	0.36% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.