Releases: auth0/auth0-python
Releases · auth0/auth0-python
5.6.0
Changes
Added
- feat: rate_limit_policies client with full CRUD: list, create, get, update, delete #853 (fern-api[bot])
- feat: Response Types: RateLimitPolicyConfigurationZero (allow), RateLimitPolicyConfigurationOne (block/log + limit), RateLimitPolicyConfigurationAction (redirect + limit + redirect_uri), RateLimitPolicy #853 (fern-api[bot])
- feat: OAuth scopes: create:rate_limit_policies, read:rate_limit_policies, update:rate_limit_policies, delete:rate_limit_policies #853 (fern-api[bot])
- feat: Support for groups.roles — list, create, delete #853 (fern-api[bot])
- feat: Support for roles.groups — get, create, delete #853 (fern-api[bot])
- feat: Support for users.effective_roles / users.effective_roles.sources.groups #853 (fern-api[bot])
- feat: Support for users.effective_permissions / users.effective_permissions.sources.roles #853 (fern-api[bot])
- feat: Support for organizations.groups — list #853 (fern-api[bot])
- feat: Support for organizations.groups.roles — list, create, delete #853 (fern-api[bot])
- feat: Support for organizations.members.effective_roles / organizations.members.effective_roles.sources.groups #853 (fern-api[bot])
- feat: Types for SCIM Groups: effective role/permission response types, org-member effective role types, paginated list wrappers, source enum discriminators #853 (fern-api[bot])
- feat: OAuth scopes: create/read/delete:group_roles, read:organization_groups, create/read/delete:organization_group_roles, read:organization_member_effective_roles, read:organization_member_role_source_groups, read:user_effective_roles, read:user_role_source_groups, read:user_effective_permissions, read:user_permission_source_roles #853 (fern-api[bot])
Changed
- ConnectionPropertiesOptions — dpop_signing_alg field added (write path for POST /api/v2/connections) #853 (fern-api[bot])
- UpdateConnectionOptions — dpop_signing_alg field added (write path for PATCH /api/v2/connections/{id}) #853 (fern-api[bot])
5.5.0
- Python 3.9 reached end-of-life in October 2025. This release requires Python >=3.10. Users on Python 3.9 should remain on v5.4.0 until they upgrade their Python version. #843 (developerkunal)
Added
- feat: configurable max_retries parameter to Auth0 and AsyncAuth0 clients (defaults to 2 with exponential backoff) #841 (fern-api[bot])
- feat: New error types: BadRequestSchema, ForbiddenSchema, UnauthorizedSchema, TooManyRequestsSchema #841 (fern-api[bot])
- feat: New types: FedCmLogin, FedCmLoginGoogle, CredentialDeviceTypeEnum #841 (fern-api[bot])
- Extended user_authentication_method and resource_server response types with additional fields #841 (fern-api[bot])
- Expanded clients, refresh_tokens, resource_servers, tickets, and users/authentication_methods endpoint parameters
Changed
- Updated connection types with additional validation fields #841 (fern-api[bot])
5.4.0
Added
- chore: Add events module, async token support, and connection retry resilience #835 (fern-api[bot])
Changed
- [fern-replay] Initialize Replay for SDK customizations #833 (fern-api[bot], developerkunal)
Fixed
- fix: Add top-level
py.typedmarker to resolve IDE import errors #829 (kishore7snehil)
5.3.0
Added
- feat: Add CIMD support, organization connections, group deletion, refresh token listing; remove AOL/Flickr/Yammer providers #816 (fern-api[bot])
- feat:Add
Auth0-Custom-Domainheader support for Multiple Custom Domains (MCD) #799 (kishore7snehil)
5.2.0
- Python 3.8 reached end-of-life in October 2024. This release requires Python >=3.9.2. Users on Python 3.8 should remain on v5.1.0 until they upgrade their Python version. #808
Added
- feat: Add default domain endpoints, connection key provisioning, tenant SCIM listing; remove MiiCard/Renren providers #801 (fern-api[bot])
- feat: Add client_info support for custom telemetry in Authentication and Management clients #802 (kishore7snehil)
- feat: Add SDK logging infrastructure with configurable log levels and header redaction #785 (fern-api[bot])
Fixed
- fix: Pagination page advancement incorrectly skipping pages #785 (fern-api[bot])
Changed
- chore: Update ruff, aiohttp, cryptography, urllib3, codecov-action; replace Snyk with SCA scan #808 (kishore7snehil)
5.1.0
Fixed
- fix: Remove placeholder defaults from optional parameters + additional updates #778 (fern-api[bot])
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
SyncPagerandAsyncPagerclasses 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 Auth0tofrom auth0.management import ManagementClient - Client initialization changed from
Auth0(domain, management_token)toManagementClient(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 usetake - Python version requirement increased from ≥3.7 to ≥3.8
- Error handling changed from
Auth0ErrortoApiErrorbase class
Important Notes
- ✅ The
authenticationpackage 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
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
AsyncAuth0andAsyncManagementClient - 📄 Automatic Pagination: Built-in pagination support with
include_totals=Trueby default
🔀 Compare Changes: Full Changelog
4.13.0
4.12.0
Added
- Updates for CIBA with email #720 (adamjmcgrath)