Skip to content

1.0.0-beta.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 09 Apr 10:36
1.0.0-beta.0
48f8b78
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Change Log

1.0.0-beta.0 (2026-04-09)

v1.0.0-beta.0 is the first release of the Auth0 My Organization .NET SDK — a fully OpenAPI-generated SDK for the Auth0 My Organization API, built with Fern:

  • 🔑 Automatic Token Management: The new MyOrganizationClient wrapper handles token acquisition, caching, and refresh automatically — no manual token management needed.
  • 🔒 Flexible Authentication: Supports client secret (ClientCredentialsTokenProvider.WithClientSecret) and private key JWT (ClientCredentialsTokenProvider.WithClientAssertion) out of the box. Bring your own token source via DelegateTokenProvider.
  • 📂 Organized Sub-Clients: API operations are grouped into logical hierarchical sub-clients — OrganizationDetails, Organization.Domains, Organization.IdentityProviders, Organization.Configuration, and more — for clear discoverability.
  • 🛡️ Strong Type Safety: All API operations use typed request/response models with full nullable reference type support.
  • ⚡ Typed Exception Handling: Specific exception types for each HTTP error status — BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ConflictError, TooManyRequestsError.
  • 📡 Raw HTTP Response Access: Access status codes, headers, and URL alongside your parsed data via .WithRawResponse().
  • 🏷️ Optional<T> Type: Cleanly distinguish between "field omitted" and "field explicitly set to null" in PATCH operations.
  • 📄 Async Pagination: Cursor-based pagination with IAsyncEnumerable<Page<T>> via Pager<T> and BiPager<T>.
  • 🔃 Automatic Retries: Exponential backoff with jitter on 408, 429, and 5XX responses; respects Retry-After and X-RateLimit-Reset headers.
  • 🧩 Per-Request Options: Override timeout, retries, headers, base URL, and query/body parameters on any individual call via RequestOptions.
  • 📋 Auth0-Client Telemetry: The Auth0-Client header is sent automatically on every request with SDK name, version, and .NET runtime target.

📦 Installation

Install via NuGet:

dotnet add package Auth0.MyOrganizationApi --version 1.0.0-beta.0

Or add to your .csproj:

<PackageReference Include="Auth0.MyOrganizationApi" Version="1.0.0-beta.0" />

Supported Platforms

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

🚀 Quick Start

using Auth0.MyOrganizationApi;

var client = new MyOrganizationClient(new MyOrganizationClientOptions
{
    Domain = "mytenant.auth0.com",
    TokenProvider = ClientCredentialsTokenProvider
        .WithClientSecret(
            "mytenant.auth0.com",
            "<YOUR_CLIENT_ID>",
            "<YOUR_CLIENT_SECRET>"
        )
        .Build()
});

var details = await client.OrganizationDetails.GetAsync();
Console.WriteLine(details);

⚠️ Beta Notice

This is a beta release. The API surface may change before the GA release based on feedback. We encourage you to try it out and share your thoughts.

🙏 Thank You

Thank you to everyone who has been testing early builds and providing feedback — it's been invaluable in shaping this release.

We'd love to hear how it works for your use case. Please open an issue if you run into anything or have suggestions.

Assets 2
Loading