release: 5.0.0 by stainless-app[bot] · Pull Request #2702 · cloudflare/cloudflare-python · GitHub

Automated Release PR

5.0.0 (2026-04-30)

This is a major release of the Cloudflare Python SDK. It drops support for
Python 3.8, adds 11 new API services, introduces optional aiohttp backend
support for improved async concurrency, and includes hundreds of type and
method updates across the entire API surface.

Please review the breaking changes below before upgrading. A migration guide
is available at docs/migration-guides/v5.0.0-migration-guide.md.

Breaking Changes

Python 3.8 is no longer supported. The minimum required version is now Python 3.9. (pyproject.toml)
typing-extensions minimum version bumped from >=4.10 to >=4.14.

Additionally, the following resources have breaking changes:

abusereports
acm.totaltls
apigateway.configurations
cloudforceone.threatevents
d1.database
intel.indicatorfeeds
logpush.edge
origintlsclientauth.hostnames
queues.consumers
radar.bgp
rulesets.rules
schemavalidation.schemas
snippets
zerotrust.dlp
zerotrust.networks

See the v5.0.0 Migration Guide for upgrade instructions and resource-specific guidance.

Features

aiohttp backend support: The async client now supports an optional aiohttp HTTP backend for improved concurrency performance. Install with pip install cloudflare[aiohttp] and use DefaultAioHttpClient() as the http_client parameter.
Python 3.13 and 3.14 support added as tested classifiers.

New Services

The following top-level resources are new in this release:

AISearch (aisearch): AI-powered search capabilities
Connectivity (connectivity): Connectivity testing and diagnostics
EmailSending (email_sending): Email send and send_raw endpoints
Fraud (fraud): Fraud detection and prevention
GoogleTagGateway (google_tag_gateway): Google Tag Gateway management
Organizations (organizations): Organization audit logs and management
R2DataCatalog (r2_data_catalog): R2 Data Catalog operations
RealtimeKit (realtime_kit): Realtime communication (Calls/TURN)
ResourceTagging (resource_tagging): Resource tagging and labeling
TokenValidation (token_validation): Token validation configuration and rules
VulnerabilityScanner (vulnerability_scanner): Vulnerability scanning, credential sets, and target environments

New Endpoints on Existing Services

accounts: update generated types and methods
api_gateway: add labels endpoints (WAM-1196)
billing: add billable usage PayGo endpoint
brand_protection: add v2 endpoints
browser_rendering: add devtools methods (BRAPI-1051)
cache: add origin cloud regions resource
custom_origin_trust_store: enable custom origin trust store
dns: add dns_records/usage endpoints (DNS-12466)
email_security: add phishguard reports endpoint
iam: add user_groups and user_group_members resources
radar: add Botnet Threat Feed and Post-Quantum endpoints
workers: add Observability Destinations resources (WO-989)
zero_trust: add Access Users endpoint (AUTH-7071), DEX rules, Device IP Profile, Device Subnet, WARP Connector connections and failover endpoints, WARP Subnet endpoints, Gateway PAC files (GIN-1439)
zones: add zone environments endpoints

Updated Services

Nearly every existing service received type and method updates through
composite API spec refreshes. Notable updates include:

email_security: remove deprecated type definitions
radar: restructured to use per-resource api.md sub-files (no client path changes)
workers_for_platforms: update generated types
r2: update generated types
fraud: update generated types and methods

Bug Fixes

_models: add polymorphic_serialization parameter to model_dump overrides (342b5a8)
pipelines: add BaseModel base to response SchemaFieldStruct/SchemaFieldList stubs (d33af8b)
dlp: add missing model_rebuild/update_forward_refs for SharedEntryCustomEntry classes (25ec10c)
workers: make RunQueryParametersNeedleValue a BaseModel with arbitrary_types_allowed (6b7efbc)
stream: remove duplicate notification_url field in webhook response types (fc9fb2f)
resolve pre-existing codegen type errors (fed88d6)
radar: fix type: ignore[call-arg] placement for mypy compatibility (fac9404)
fix broken reference for the queues consumer model (3f5cf39)

Chores

build: migrate from rye to uv for project management (2f283c2)
ci: pin single Python version and pydantic v2 for test runs (86676bc)
typing: add mypy configuration with strict mode (pyproject.toml)
api: 80+ composite API spec updates across the release cycle

Documentation

add Authentication section to README (70d934a)
add aiohttp backend usage instructions to README
add MCP server integration badges (Cursor, VS Code)

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

…points * feat(radar): add AI markdown for agents and agent readiness endpoints

* feat(registrar): add registrations list method on main Add registrar.registrations.list to the main registrar resource so the new GET /accounts/{account_id}/registrar/registrations endpoint is exposed through the converged Registrar surface on main as well as staging.

…d account IDs * feat: add env var readability for zone_id and account_id client options * feat: enable treeshaking and client options for setting zone and account IDs

…7 [production] * feat(api): Add mapping for `/dlp/settings` endpoint Add mapping and terraform resource for `/dlp/settings` endpoint.

…-namespaced items (prod) * fix(workers): RAG-934 enable terraform for dispatch namespaces * fix(workers_for_platforms): restore dispatch namespaces correct indentation * feat(ai_search): skip terraform on namespaces instances jobs and items * feat(ai_search): fix move endpoint path and skip terraform on namespaces instances * feat(ai_search): skip terraform generation for namespaces * fix(ai_search): correct indentation and rename edit to move * feat(ai_search): add namespace endpoints and remove non-namespaced items

* chore: skip tests

* chore: trigger build

* fix: add test skips for custom_pages.assets, fix YAML syntax custom_pages.assets: all 5 methods (create, update, list, delete, get) fail because generated tests don't pass the required zone_id argument. Also fixes a YAML syntax error on line 89 (two key-value pairs merged onto one line).

docs: add Authentication section to README

- Switch package manager from rye to uv across pyproject.toml, CI workflows, and scripts - Update devcontainer configuration for uv - Remove noxfile.py and requirements.lock (replaced by uv.lock) - Update .stats.yml codegen metadata - Update organizations types __init__.py barrel export

…verrides Pydantic 2.13 added polymorphic_serialization (bool | None) to model_dump and model_dump_json. The pydantic v1 compat overrides in _models.py need to match the new signature to satisfy pyright.

mypy attributes the files= kwarg error to the _get_api_list() call expression, not the argument line. Move the suppression comment to where mypy expects it while keeping pyright's ignore on the arg line.

The full matrix (2 Python versions x 2 pydantic versions = 3 runs) causes CI timeouts. Run only min Python + pydantic v2 to keep CI within the 30 minute budget. The full matrix can be run manually via scripts/test when needed.

Set UV_PYTHON to skip the multi-Python loop while still running both pydantic v2 and v1 tests. This matches the old rye-based CI behavior (2 test runs instead of 3).

Sync staged changes (curated)

@musa-cf reminder to update the PR title and remove the beta

Release version edited manually

The Pull Request version has been manually set to 5.0.0 and will be used for the release.

If you instead want to use the version number 5.0.0-beta.3 generated from conventional commits, just remove the label autorelease: custom version from this Pull Request.

🤖 Release is at https://github.com/cloudflare/cloudflare-python/releases/tag/v5.0.0 🌻

stainless-app Bot added 30 commits April 15, 2026 09:10

chore(api): update composite API spec

53c2e1f

codegen metadata

e17fb79

codegen metadata

33fd9e6

chore(api): update composite API spec

e7ee358

feat: feat(radar): add AI markdown for agents and agent readiness end…

5ec0a7b

…points * feat(radar): add AI markdown for agents and agent readiness endpoints

codegen metadata

919dbc1

feat: feat: enable treeshaking and client options for setting zone an…

1373bb4

…d account IDs * feat: add env var readability for zone_id and account_id client options * feat: enable treeshaking and client options for setting zone and account IDs

feat: feat(api): Add mapping for /dlp/settings endpoint for DLP-454…

29a0e8f

…7 [production] * feat(api): Add mapping for `/dlp/settings` endpoint Add mapping and terraform resource for `/dlp/settings` endpoint.

codegen metadata

c69cf24

codegen metadata

7a61c6f

codegen metadata

384f624

codegen metadata

de3711e

codegen metadata

6505fee

chore(api): update composite API spec

dd4f5d0

codegen metadata

ed35936

codegen metadata

2685e87

chore(api): update composite API spec

1f4de90

chore(api): update composite API spec

be02a41

codegen metadata

18a17f5

chore(internal): codegen related update

45b58ae

codegen metadata

becb369

chore(api): update composite API spec

926d1ec

chore(api): update composite API spec

3a1b2f7

codegen metadata

8d31f23

chore(api): update composite API spec

ab9ac01

feat: chore: skip tests

ab4bf86

* chore: skip tests

feat: chore: trigger build

fc1a60d

* chore: trigger build

Merge pull request #2708 from cloudflare/docs/add-authentication-section

e4b3835

docs: add Authentication section to README

stainless-app Bot force-pushed the release-please--branches--main--changes--next branch from ba4a793 to 39a6939 Compare April 30, 2026 14:42

musa-cf self-assigned this Apr 30, 2026

musa-cf added 13 commits April 30, 2026 12:21

chore(accounts): update generated types

7ff4adf

chore(aisearch): update generated types, remove unused tests

e20c138

chore(email_security): remove deprecated type definitions

878e3d4

chore(fraud): update generated types and methods

771c7e4

chore(r2): update generated types

2e7856d

chore(radar): update to_markdown type ignore comments

d721964

chore(workers_for_platforms): update generated types

f342310

fix(_models): add polymorphic_serialization parameter to model_dump o…

342b5a8

…verrides Pydantic 2.13 added polymorphic_serialization (bool | None) to model_dump and model_dump_json. The pydantic v1 compat overrides in _models.py need to match the new signature to satisfy pyright.

fix(radar): move type: ignore[call-arg] to call site for mypy

fac9404

mypy attributes the files= kwarg error to the _get_api_list() call expression, not the argument line. Move the suppression comment to where mypy expects it while keeping pyright's ignore on the arg line.

fix(ci): pin single Python version to match pre-uv test behavior

86676bc

Set UV_PYTHON to skip the multi-Python loop while still running both pydantic v2 and v1 tests. This matches the old rye-based CI behavior (2 test runs instead of 3).

Merge pull request #2709 from cloudflare/sync/staging-next-2026-04-30

8179b62

Sync staged changes (curated)

stainless-app Bot force-pushed the release-please--branches--main--changes--next branch from 39a6939 to a24657f Compare April 30, 2026 20:03

vaishakdinesh approved these changes Apr 30, 2026

View reviewed changes

musa-cf changed the title release: 5.0.0-beta.3 release: 5.0.0 Apr 30, 2026

stainless-app Bot added the autorelease: custom version label Apr 30, 2026

release: 5.0.0

6b44004

stainless-app Bot force-pushed the release-please--branches--main--changes--next branch from a24657f to 6b44004 Compare April 30, 2026 20:34

chore: v5.0.0 changelog and migration guide

0e138b9

musa-cf merged commit d05d813 into main Apr 30, 2026
14 of 15 checks passed

musa-cf deleted the release-please--branches--main--changes--next branch April 30, 2026 23:26

stainless-app Bot added autorelease: tagged and removed autorelease: pending labels Apr 30, 2026

release: 5.0.0 by stainless-app[bot] · Pull Request #2702 · cloudflare/cloudflare-python · GitHub

Uh oh!

release: 5.0.0 - #2702

release: 5.0.0#2702
musa-cf merged 76 commits into
mainfrom
release-please--branches--main--changes--next

stainless-app Bot commented Apr 24, 2026 •
edited by musa-cf
Loading

Uh oh!

Uh oh!

vaishakdinesh commented Apr 30, 2026

Uh oh!

stainless-app Bot commented Apr 30, 2026

Uh oh!

Uh oh!

stainless-app Bot commented Apr 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

release: 5.0.0 by stainless-app[bot] · Pull Request #2702 · cloudflare/cloudflare-python · GitHub

Uh oh!

release: 5.0.0 - #2702

release: 5.0.0#2702musa-cf merged 76 commits intomaincloudflare/cloudflare-python:mainfrom release-please--branches--main--changes--nextcloudflare/cloudflare-python:release-please--branches--main--changes--nextCopy head branch name to clipboard

Conversation

stainless-app Bot commented Apr 24, 2026 • edited by musa-cf Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Automated Release PR

5.0.0 (2026-04-30)

Breaking Changes

Features

New Services

New Endpoints on Existing Services

Updated Services

Bug Fixes

Chores

Documentation

Uh oh!

vaishakdinesh commented Apr 30, 2026

Uh oh!

stainless-app Bot commented Apr 30, 2026

Release version edited manually

Uh oh!

Uh oh!

stainless-app Bot commented Apr 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

release: 5.0.0#2702
musa-cf merged 76 commits into
mainfrom
release-please--branches--main--changes--next

stainless-app Bot commented Apr 24, 2026 •
edited by musa-cf
Loading