v2.2.0

Added

• SDK Update: Connection Profiles, Express Configuration, and API Enhancements #653 (fern-api[bot])

v1.32.0

Added

• feat: [Superfed] go-auth0 SDK Support #652 (developerkunal)
• feat: Support Ephemeral Lifetime configuration in the Tenant Settings #614 (nelsonmaia)
• feat: Refactor PromptRendering handling #594 (ramya18101)

v2.1.0

Added

• feat: Add Bot Detection, CAPTCHA, Organization Discovery Domains, and other Management API updates #645 (fern-api[bot])

v1.31.0

Added

• feat: Add OAuth1 connection strategy support in ConnectionManager #640 (developerkunal)
• feat: Add AsyncApprovalNotificationChannels support to Client #635 (developerkunal)
• feat: support Organization Domain Discovery #612 (developerkunal)

v2.0.2

Fixed

• fix: correct OAuth token URL construction for all credential options #641 (developerkunal)

v2.0.1

Added

• feat: Set default User-Agent and fix request option merging #625 (developerkunal)

Fixed

• fix: ensure consistent pagination defaults across management API client methods #629 (fern-api[bot])

v2.0.0

What's New in v2.0.0

⚠️ BREAKING CHANGES - Major Rewrite

This is a complete rewrite of the Auth0 Go SDK with significant breaking changes from v1.x. Users will need to update their code when migrating from v1.x to v2.0.0.

Added Features

• New OpenAPI-generated SDK: Complete rewrite generated from Auth0's OpenAPI specifications
• Hierarchical package structure: Organized management APIs into logical subpackages
• Strongly typed interfaces: Specific request/response types replace generic interfaces
• Enhanced type safety: Enums and constants replace string literals
• Improved error handling: Structured error types with better error messages
• Better IntelliSense support: Improved code completion and documentation

Key Breaking Changes

• Module name changed from github.com/auth0/go-auth0 to github.com/auth0/go-auth0/v2
• Client initialization changed from management.New() to client.New() with new option pattern
• Manager structure changed from flat (mgmt.User) to hierarchical (mgmt.Users)
• Method signatures now require specific request objects instead of generic structs
• Response types are now specific to each operation
• Package organization changed from flat structure to organized subpackages
• Configuration pattern changed to use option.RequestOption types

Migration Example

Before (v1):

import "github.com/auth0/go-auth0/management"

mgmt, err := management.New(domain,
    management.WithClientCredentials(ctx, clientID, clientSecret))

client := &management.Client{
    Name: auth0.String("My App"),
    AppType: auth0.String("spa"),
}
err := mgmt.Client.Create(ctx, client)

After (v2):

import (
    "github.com/auth0/go-auth0/v2/management"
    "github.com/auth0/go-auth0/v2/management/client"
    "github.com/auth0/go-auth0/v2/option"
)

mgmt, err := client.New("your-domain.auth0.com",
    option.WithClientCredentials(ctx, clientID, clientSecret))

request := &management.CreateClientRequestContent{
    Name: "My App",
    AppType: &management.ClientAppTypeEnumSpa,
}
response, err := mgmt.Clients.Create(ctx, request)

Important Notes

• ✅ The authentication package is NOT affected by these changes. Authentication APIs remain the same between V1 and V2.
• 📖 Complete migration guide available at MIGRATION_GUIDE.md
• 🔄 This is the stable GA release following v2.0.0-beta.0

v1.30.0

Added

• feat: add SSO ticket endpoint to custom domain header whitelist paths #615 (developerkunal)
• feat: support connection purpose configuration options #602 (developerkunal)

v1.29.0

Added

• feat(user): add UserConnectedAccountList type and ListConnectedAccounts method #611 (developerkunal)
• feat: self-service SSO user attribute profile updates #610 (ewanharris)
• feat: add SkipNonVerifiableCallbackURIConfirmationPrompt to Tenant and Client for custom URI schemes #609 (developerkunal)
• fix: Added unique attribute to schema for ConnectionOptionsEmailAttribute #607 (duedares-rvj)
• feat(oidc): add oidc_metadata field to connection options and update tests #606 (developerkunal)

v1.28.0

Added

• feat: Events - Support for Test, Delivery, Redelivery and Stats #580 (duedares-rvj)
• feat: add Token Vault support, ResourceServerIdentifier to Client, and ClientID to ResourceServer #593 (developerkunal)