Skip to content

v5.0.0-beta.0

Pre-release
Pre-release
Compare
Choose a tag to compare
@github-actions github-actions released this 08 Aug 18:42
v5.0.0-beta.0
b5a742e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Important: This is a beta release of the upcoming major version. It introduces breaking changes, particularly in the Management API client. Please refer to the v5 Migration Guide for detailed upgrade instructions.

💥 Breaking Changes

Node.js Version Support

  • The SDK now requires Node.js ^20.19.0, ^22.12.0, or ^24.0.0.
  • Support for earlier Node.js versions has been dropped.
  • Querying clients by organization-related attributes using the q parameter is no longer available in v5. A new search() method is coming soon. In the meantime, use the v4.x-compatible auth0/legacy legacy client to run those queries.

Management API Client Redesign

  • The Management API client has been fully restructured using Fern for code generation.
  • Methods are now organized into modular sub-clients, improving structure and maintainability.
  • Method names and signatures have changed, adopting consistent and predictable naming conventions.
  • These changes are not backward compatible with the v4.x client.

✨ Highlights

  • Full rewrite of the Management API client using Fern
  • Stronger TypeScript support with standardized error handling and improved developer ergonomics
  • Modular sub-client architecture for better discoverability and consistency
  • The Authentication API client remains fully compatible — no breaking changes
  • Introduced a v4.x-compatible legacy client available via auth0/legacy
  • Introduced modern package exports with support for both CommonJS and ESM
  • Updated minimum Node.js requirement as noted above

📘 Migration Guide: v5_MIGRATION_GUIDE.md
🔀 Compare Changes: Full Changelog

Assets 2
Loading