mgmt-8.1.0

Added

• Adds support to Get and Set Default Custom Domains #973 (fern-api[bot])
• Adds support to manage CIMD #973 (fern-api[bot])
• Adds new sub-client for Organization Connections endpoints #973 (fern-api[bot])

Removed

• Deprecated connection types: Flickr, AOL #973 (fern-api[bot])

mgmt-7.47.0

Added

• mgmt: Adds support to GET/PATCH default Custom domain #958 (kailash-b)

mgmt-8.0.0

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+

7.45.1

Security

• Bump Microsoft.IdentityModel.Protocols.OpenIdConnect and System.IdentityModel.Tokens.Jwt to v8.17.0 #955 (kailash-b)

mgmt-7.46.0

Added

• mgmt: Adds Checkpoint Pagination support for fetching CustomDomains #939 (kailash-b)
• mgmt: Add support for optional custom domain header on whitelisted endpoints #943 (kailash-b)

Fixed

• mgmt: Add async_approval_notification_channels property to client model #938 (trivm963)

mgmt-7.45.1

Added

• mgmt: Adds missing fields in Create/Update connections #929 (kailash-b)

mgmt-8.0.0-beta.1

8.0.0-beta.1 (2026-03-02)

Full Changelog

Added

• Generated the SDK against the latest available spec.

Changed

• Dropped compile time support for .NET 8.0.

Fixed

• Issue with rendering summary docs for some methods/classes.
• Refactored automatic token management wrapper to support custom token providers and asynchronous token acquisition. #926 (kailash-b)

7.45.0

Fixed

• Fix Base64Url encoding and harden authentication input validation #919 (kailash-b)

Security

• Upgrade Microsoft.IdentityModel.Protocols.OpenIdConnect & System.IdentityModel.Tokens.Jwt to 8.16.0 #922 (kailash-b)

mgmt-7.45.0

Fixed

• mgmt: Fixes an issue in parsing JobErrorDetails when the job returns an empty array #921 (kailash-b)

mgmt-8.0.0-beta.0

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)