5.0.0

What's New in v5.0.0

⚠️ BREAKING CHANGES - Major Rewrite

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

Added Features

• New Fern-generated SDK: Complete Management API rewrite generated from Auth0's OpenAPI specifications
• Hierarchical package structure: Organized Management APIs into logical sub-clients for better discoverability
• Strongly typed interfaces: Pydantic models provide specific request/response types replacing generic dictionaries
• Automatic token management: Built-in client credentials handling with automatic token refresh
• Enhanced pagination: New SyncPager and AsyncPager classes for easy iteration over paginated results
• First-class async support: Full async/await support with AsyncManagementClient
• Better IDE support: Improved code completion, type hints, and inline documentation

Key Breaking Changes

• Import paths changed from from auth0.management import Auth0 to from auth0.management import ManagementClient
• Client initialization changed from Auth0(domain, management_token) to ManagementClient(domain, client_id, client_secret) with automatic token management
• Response types changed from dictionaries to Pydantic models (use .model_dump() to convert back to dict)
• Method organization changed from flat (client.users.list()) to hierarchical where applicable
• Pagination parameters changed - some endpoints use per_page, others use take
• Python version requirement increased from ≥3.7 to ≥3.8
• Error handling changed from Auth0Error to ApiError base class

Important Notes

• ✅ The authentication package is NOT affected by these changes. Authentication APIs remain the same between v4 and v5.
• 📚 Complete migration guide available at v5_MIGRATION_GUIDE.md
• 🎯 This is the stable GA release following v5.0.0-beta.0
• 🔧 Auth0 telemetry headers implemented with dynamic versioning (no manual updates needed)
• 📖 Full API reference available at reference.md

5.0.0b0

⚠️ BREAKING CHANGES - Major Rewrite

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.

---

✍️ What's New

• ✨ OpenAPI-Generated: Complete rewrite generated from Auth0's OpenAPI specifications using Fern
• 📦 Better Organization: Hierarchical package structure with logical sub-clients for improved discoverability
• 🔒 Type Safety: Strongly typed request/response objects using Pydantic replace generic dictionaries
• ✨ Enhanced Developer Experience: Better IntelliSense, code completion, and documentation
• 🚀 Future-Proof: Easier maintenance and updates as Auth0's API evolves
• ⚡ Async Support: First-class async client with AsyncAuth0 and AsyncManagementClient
• 📄 Automatic Pagination: Built-in pagination support with include_totals=True by default

🔀 Compare Changes: Full Changelog

4.13.0

Added

• fix(backchannel): expose headers on slow_down errors (HTTP 429s) #744 (pmalouin)

4.12.0

Added

• Updates for CIBA with email #720 (adamjmcgrath)

4.11.0

Added

• feat: Support For Network ACL Endpoints #706 (kishore7snehil)

Fixed

• chore: fix workflow syntax errors and update dependencies #724 (kishore7snehil)

4.10.0

Added

• chore: merge community PRs – bugfixes, features, and dependency upgrades #696 (kishore7snehil)

  • Features

    • Self Service Profiles Support (nzetzl)

  • Fixes

    • Adding Global Seed (allrob23)

Fixed

• fix: handle authorization_details in back_channel_login #695 (kishore7snehil)

4.9.0

Added

• feat: Federated Connections Support #682 (kishore7snehil)
• Adding Support For CIBA with RAR #679 (kishore7snehil)

4.8.1

Fixed

• Fix: Unauthorized Access Error For PAR #671 (kishore7snehil)

4.8.0

Added

• Adding Support For RAR and JAR Requests #659 (kishore7snehil)
• Adding Support For Back Channel Login #643 (kishore7snehil)

Fixed

• Consolidated Community PRs and Dependency Upgrades #660 (kishore7snehil)

  • fix typo in docstring (@CarlosEduR )
  • Added support for "include_totals" to all_organization_member_roles (@jpayton-cx)
  • Fixed Version Table (@sanchez)
  • Remove upper bounds on all python dependency versions (@ngfeldman)
  • Adding secrets to Codecov Action Upload (@developerkunal)

• Updating Dependancies And Workflow Action Versions #653 (kishore7snehil)

• Fixing the Github Workflow Issues #644 (kishore7snehil)

4.7.2

Security

• Update cryptography requirements.txt #630 (duedares-rvj)