Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .version
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
5.0.0b0
39 changes: 39 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,44 @@
# Change Log

## [5.0.0b0](https://github.com/auth0/auth0-python/tree/5.0.0b0) (2025-12-18)
[Full Changelog](https://github.com/auth0/auth0-python/compare/4.13.0...5.0.0b0)

⚠️ **BETA RELEASE** - This is a beta release with significant breaking changes. Please test thoroughly before upgrading production systems.

**Breaking Changes**

- **Complete rewrite of Management API client** - Generated from Auth0's OpenAPI specifications using [Fern](https://buildwithfern.com)
- **Python 3.7 support dropped** - Minimum required version is now Python 3.8
- **Management API client restructured** - Methods organized into modular sub-clients for better discoverability
- **Method signatures changed** - Consistent and predictable naming conventions across all endpoints
- **Response types changed** - Strongly-typed Pydantic models replace generic dictionaries
- **Import paths changed** - `from auth0.management.core.api_error import ApiError` instead of `from auth0.exceptions import Auth0Error`
- **Pagination defaults changed** - `include_totals=True` is now the default for list operations
- **Client initialization simplified** - `ManagementClient` takes `domain` instead of full `base_url`

**Added**

- First-class async support with `AsyncAuth0` and `AsyncManagementClient`
- Automatic token management with client credentials in `ManagementClient`
- Built-in pagination support with `include_totals=True` by default
- Type-safe request/response objects using Pydantic models
- Better IntelliSense and code completion support
- Comprehensive API reference documentation
- Migration guide for upgrading from v4.x

**Changed**

- Management API client fully regenerated using Fern
- Package structure reorganized with hierarchical sub-clients
- Error handling updated to use `ApiError` base class
- Documentation updated with v5 examples

**Note**

- Authentication API remains **fully backward compatible** - no changes required
- See [v5_MIGRATION_GUIDE.md](https://github.com/auth0/auth0-python/blob/v5/v5_MIGRATION_GUIDE.md) for detailed upgrade instructions


## [4.13.0](https://github.com/auth0/auth0-python/tree/4.13.0) (2025-09-17)
[Full Changelog](https://github.com/auth0/auth0-python/compare/4.12.0...4.13.0)

Expand Down
9 changes: 8 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,10 +30,17 @@ The Auth0 Python library provides convenient access to the Auth0 APIs from Pytho

## Installation

> ⚠️ **This is a beta release (v5.0.0-beta)** of a major rewrite with breaking changes. See the [Migration Guide](v5_MIGRATION_GUIDE.md) for upgrade instructions from v4.x.

**Install the v5 beta:**

```sh
pip install auth0-python
pip install auth0-python==5.0.0b0
```

**Requirements:**
- Python ≥3.8 (Python 3.7 support has been dropped)

## Reference

A full reference for this library is available [here](https://github.com/auth0/auth0-python/blob/HEAD/./reference.md).
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name = "auth0-python"

[tool.poetry]
name = "auth0-python"
version = "4.13.0"
version = "5.0.0b0"
description = "Auth0 Python SDK - Management and Authentication APIs"
readme = "README.md"
authors = ["Auth0 <support@auth0.com>"]
Expand Down