From 4ca06bfe04870ea8acb90b13e79af706f7a67a40 Mon Sep 17 00:00:00 2001
From: Snehil Kishore <snehil.kishore@okta.com>
Date: Thu, 18 Dec 2025 17:43:56 +0530
Subject: [PATCH] Release 5.0.0b0

---
 .version       |  1 +
 CHANGELOG.md   | 39 +++++++++++++++++++++++++++++++++++++++
 README.md      |  9 ++++++++-
 pyproject.toml |  2 +-
 4 files changed, 49 insertions(+), 2 deletions(-)
 create mode 100644 .version

diff --git a/.version b/.version
new file mode 100644
index 00000000..c3d3a554
--- /dev/null
+++ b/.version
@@ -0,0 +1 @@
+5.0.0b0
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2cd01db7..9719097b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -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)
 
diff --git a/README.md b/README.md
index dcd7b5c1..b5f46afc 100644
--- a/README.md
+++ b/README.md
@@ -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).
diff --git a/pyproject.toml b/pyproject.toml
index 9c6dbb5c..cc25a1ef 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -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>"]