release: 4.4.0

.github/workflows/ci.yml

@@ -8,6 +8,10 @@ on:
       - 'integrated/**'
       - 'stl-preview-head/**'
       - 'stl-preview-base/**'
+  pull_request:
+    branches-ignore:
+      - 'stl-preview-head/**'
+      - 'stl-preview-base/**'
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -18,6 +22,7 @@ jobs:
     timeout-minutes: 10
     name: lint
     runs-on: ${{ github.repository == 'stainless-sdks/cloudflare-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
       - uses: actions/checkout@v4
 
@@ -35,17 +40,31 @@ jobs:
       - name: Run lints
         run: ./scripts/lint
 
-  upload:
-    if: github.repository == 'stainless-sdks/cloudflare-python'
+  build:
+    if: github.repository == 'stainless-sdks/cloudflare-python' && (github.event_name == 'push' || github.event.pull_request.head.repo.fork)
     timeout-minutes: 10
-    name: upload
+    name: build
     permissions:
       contents: read
       id-token: write
     runs-on: depot-ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
 
+      - name: Install Rye
+        run: |
+          curl -sSf https://rye.astral.sh/get | bash
+          echo "$HOME/.rye/shims" >> $GITHUB_PATH
+        env:
+          RYE_VERSION: '0.44.0'
+          RYE_INSTALL_OPTION: '--yes'
+
+      - name: Install dependencies
+        run: rye sync --all-features
+
+      - name: Run build
+        run: rye build
+
       - name: Get GitHub OIDC Token
         id: github-oidc
         uses: actions/github-script@v6
@@ -63,6 +82,7 @@ jobs:
     timeout-minutes: 30
     name: test
     runs-on: ${{ github.repository == 'stainless-sdks/cloudflare-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
       - uses: actions/checkout@v4
 
@@ -84,7 +104,7 @@ jobs:
     timeout-minutes: 10
     name: examples
     runs-on: ${{ github.repository == 'stainless-sdks/cloudflare-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.repository == 'cloudflare/cloudflare-python'
+    if: github.repository == 'cloudflare/cloudflare-python' && (github.event_name == 'push' || github.event.pull_request.head.repo.fork)
 
     steps:
       - uses: actions/checkout@v4

.github/workflows/detect-breaking-changes.yml

@@ -0,0 +1,35 @@
+name: CI
+on:
+  pull_request:
+    branches:
+      - main
+      - next
+
+jobs:
+  detect_breaking_changes:
+    runs-on: 'ubuntu-latest'
+    name: detect-breaking-changes
+    if: github.repository == 'cloudflare/cloudflare-python'
+    steps:
+      - name: Calculate fetch-depth
+        run: |
+          echo "FETCH_DEPTH=$(expr ${{ github.event.pull_request.commits }} + 1)" >> $GITHUB_ENV
+
+      - uses: actions/checkout@v4
+        with:
+          # Ensure we can check out the pull request base in the script below.
+          fetch-depth: ${{ env.FETCH_DEPTH }}
+
+      - name: Install Rye
+        run: |
+          curl -sSf https://rye.astral.sh/get | bash
+          echo "$HOME/.rye/shims" >> $GITHUB_PATH
+        env:
+          RYE_VERSION: '0.44.0'
+          RYE_INSTALL_OPTION: '--yes'
+      - name: Install dependencies
+        run: |
+          rye sync --all-features
+
+      - name: Detect breaking changes
+        run: ./scripts/detect-breaking-changes ${{ github.event.pull_request.base.sha }}

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.3.1"
+  ".": "4.4.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 1752
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-b15b44e0efd207de48e7e74e742b0b4b190c74f12a941a1a0ef59a51656a5224.yml
-openapi_spec_hash: 83243c9ee06f88d0fa91e9b185d8a42e
-config_hash: 8601d43fd5ccaf9e3d08f26748a5a63a
+configured_endpoints: 1777
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-c493698a1cde78df7b38557058847107dcc8041a33b8367b7416cd3dc08324e9.yml
+openapi_spec_hash: 3202b0c046cd2617b0f8839c941ff334
+config_hash: bafeb7666d2b7868c9d4ab8f0cc686e1

CHANGELOG.md

@@ -1,5 +1,80 @@
 # Changelog
 
+## 4.4.0 (2025-07-20)
+
+Full Changelog: [v4.3.1...v4.4.0](https://github.com/cloudflare/cloudflare-python/compare/v4.3.1...v4.4.0)
+
+### Features
+
+* **api:** Add DELETE and POST routes for Magic Connector ([42705d7](https://github.com/cloudflare/cloudflare-python/commit/42705d7ab89a26af0a185b8753aa009509780c76))
+* **api:** Add Radar Bots and Web Crawlers ([4d80c55](https://github.com/cloudflare/cloudflare-python/commit/4d80c5529a4680d0cb58e63073d90edc65b289a6))
+* **api:** api update ([5364bb7](https://github.com/cloudflare/cloudflare-python/commit/5364bb7fafdd4d85525232ee90c4e7b4dbae4488))
+* **api:** api update ([0d26a36](https://github.com/cloudflare/cloudflare-python/commit/0d26a36fbcd6c82968489f22c2db349aeb020878))
+* **api:** api update ([8a99cf5](https://github.com/cloudflare/cloudflare-python/commit/8a99cf5e25f69079acbef07f32f2b728a0f10849))
+* **api:** api update ([4ec7e83](https://github.com/cloudflare/cloudflare-python/commit/4ec7e833fd5ee4250b96231366343131d0008b72))
+* **api:** api update ([a46cf0d](https://github.com/cloudflare/cloudflare-python/commit/a46cf0d8fdfc88a45ce131656a0a7c3cb9c53fcc))
+* **api:** api update ([c6096ae](https://github.com/cloudflare/cloudflare-python/commit/c6096aeb9836a7d19c358d0a0217649d9e5455dd))
+* **api:** api update ([278a799](https://github.com/cloudflare/cloudflare-python/commit/278a7997b8107d50031886fe09b0039faed7d46c))
+* **api:** api update ([3dbbe9c](https://github.com/cloudflare/cloudflare-python/commit/3dbbe9c6d42f498d303173fc5bab1c4efba3a8a6))
+* **api:** api update ([f9365f8](https://github.com/cloudflare/cloudflare-python/commit/f9365f8e7f743cf24a80049662e1fa58233e6dc5))
+* **api:** api update ([0ddeaf4](https://github.com/cloudflare/cloudflare-python/commit/0ddeaf4caf2f93c2219496bf516c68709c44f2b5))
+* **api:** api update ([dcf06c8](https://github.com/cloudflare/cloudflare-python/commit/dcf06c8b08df6d6210dd58eb968b46ec56c02077))
+* **api:** api update ([d982424](https://github.com/cloudflare/cloudflare-python/commit/d982424f3f04cb7f6d13a1d12738cafb514be1bb))
+* **api:** api update ([493c628](https://github.com/cloudflare/cloudflare-python/commit/493c6287801e269227c5a6ce58748ed30040f16d))
+* **api:** api update ([f116592](https://github.com/cloudflare/cloudflare-python/commit/f1165925dbdd92232cfce87647c568c373a6c46f))
+* **api:** api update ([b4de192](https://github.com/cloudflare/cloudflare-python/commit/b4de1922aee64c681f492c3fac24fec414d5fb84))
+* **api:** api update ([3f94ddf](https://github.com/cloudflare/cloudflare-python/commit/3f94ddfeded1cd708596ffec9c7b63a3f78951b2))
+* **api:** api update ([2d31877](https://github.com/cloudflare/cloudflare-python/commit/2d3187794d5cc12d39dacfb58b51626b03495c12))
+* **api:** api update ([f96551d](https://github.com/cloudflare/cloudflare-python/commit/f96551d3275d2c8117705c84614f924eb62da98b))
+* **api:** api update ([c78996b](https://github.com/cloudflare/cloudflare-python/commit/c78996bbe8f0e33bedf4d928d9b8878b18ec81e6))
+* **api:** api update ([427f8f1](https://github.com/cloudflare/cloudflare-python/commit/427f8f1c4f8e6431e8593718658a954b9503d41d))
+* **api:** api update ([ec2e81c](https://github.com/cloudflare/cloudflare-python/commit/ec2e81ceae5ebb21bfedb8f5706a8ce51094340a))
+* **api:** api update ([16cdf47](https://github.com/cloudflare/cloudflare-python/commit/16cdf47bdb7be097bb7a83e9ccfbdc4b61e8405b))
+* **api:** api update ([fc20862](https://github.com/cloudflare/cloudflare-python/commit/fc20862274dcf03e7e90a90b37a5b812f3c63235))
+* **api:** api update ([18a6fde](https://github.com/cloudflare/cloudflare-python/commit/18a6fdeab07b6753252135f21304dcfc2fa1faf2))
+* **api:** api update ([23499df](https://github.com/cloudflare/cloudflare-python/commit/23499df3b54944c84a552a0e20ce09b075e4bc44))
+* **api:** api update ([211ddfc](https://github.com/cloudflare/cloudflare-python/commit/211ddfcf9176cf778d6de310817ee01194f6844e))
+* **api:** api update ([2bf9737](https://github.com/cloudflare/cloudflare-python/commit/2bf9737af8db398d3e00c9ddb3f67d0c9527491f))
+* **api:** api update ([764b4ea](https://github.com/cloudflare/cloudflare-python/commit/764b4ea4333e86e8c1c76c7625887c077c435f8a))
+* **api:** api update ([4c6cda0](https://github.com/cloudflare/cloudflare-python/commit/4c6cda072e94640d2ea181dd1de2e4ef3f943e76))
+* **brand_protection:** Add new routes ([5d9961c](https://github.com/cloudflare/cloudflare-python/commit/5d9961ce4aba38d828f3279e7081b30b76db74ad))
+* clean up environment call outs ([f24f43d](https://github.com/cloudflare/cloudflare-python/commit/f24f43d8132d0efc31d49954209549932bba6f75))
+* **client:** add support for aiohttp ([80d9fef](https://github.com/cloudflare/cloudflare-python/commit/80d9fefc3aabba6ee9d6addea001a7108b9684cd))
+* **zero_trust_dlp:** Added individual resources and new routes ([96581bc](https://github.com/cloudflare/cloudflare-python/commit/96581bc4d785392715269ca32b09dfa8fce0ac51))
+
+
+### Bug Fixes
+
+* **api:** add missing `items` param ([f1eda00](https://github.com/cloudflare/cloudflare-python/commit/f1eda003cec7a593680d7e58106fad0e029cf5ee))
+* **ci:** correct conditional ([a071a9a](https://github.com/cloudflare/cloudflare-python/commit/a071a9ac7b25de7454f6ad37ee39af0f5dbcd2b0))
+* **ci:** release-doctor — report correct token name ([736bc3f](https://github.com/cloudflare/cloudflare-python/commit/736bc3f6a1009bdb69e3505c0f9116235914e4fb))
+* **client:** don't send Content-Type header on GET requests ([43041fb](https://github.com/cloudflare/cloudflare-python/commit/43041fba5e43c7e8022c5ece6d98d055e150a47b))
+* dns record example ([8f2f7a4](https://github.com/cloudflare/cloudflare-python/commit/8f2f7a4662883ae4cb85f956dda2b82a7ed952e4))
+* dns record example ([9085347](https://github.com/cloudflare/cloudflare-python/commit/908534756a4f8321407ced2dea94531e895989b8))
+* **parsing:** correctly handle nested discriminated unions ([9e6eb88](https://github.com/cloudflare/cloudflare-python/commit/9e6eb8890842b715b91c029ed3ad46b52d6fa9b3))
+* radar types ([42c2209](https://github.com/cloudflare/cloudflare-python/commit/42c22098266df3dc6ebc0c19cfec97b6d851c9cd))
+* radar types ([234b609](https://github.com/cloudflare/cloudflare-python/commit/234b609b77d476c89f92fb289d02a1aaf6decf01))
+* **tests:** fix: tests which call HTTP endpoints directly with the example parameters ([721188d](https://github.com/cloudflare/cloudflare-python/commit/721188dddf88b71ba2c0754461c8d7f8d4359304))
+
+
+### Chores
+
+* **api:** Skip broken prism test for updating custom DLP entries ([71baeb0](https://github.com/cloudflare/cloudflare-python/commit/71baeb0e4ca8145723f85233fa05cc42958a92e0))
+* **api:** skip broken prism tests ([c87b536](https://github.com/cloudflare/cloudflare-python/commit/c87b53618d2d3fde0d9f76e910bd9166d52b3b9a))
+* **ci:** change upload type ([88a9958](https://github.com/cloudflare/cloudflare-python/commit/88a99586b00f00557d5cf1b7f77979184e71034c))
+* **ci:** only run for pushes and fork pull requests ([9900f90](https://github.com/cloudflare/cloudflare-python/commit/9900f90f87f4a58b92c7f89d2b92a63be552c102))
+* **internal:** add breaking change detection ([1f93055](https://github.com/cloudflare/cloudflare-python/commit/1f930557c231be493e57c9780341916dd95bedfd))
+* **internal:** bump pinned h11 dep ([a151be0](https://github.com/cloudflare/cloudflare-python/commit/a151be01332015a572bfe280f9708a2abf82dbaf))
+* **internal:** codegen related update ([371845c](https://github.com/cloudflare/cloudflare-python/commit/371845cca805cc6fa3bb84680d4e5d698c38235e))
+* **package:** mark python 3.13 as supported ([9e18f39](https://github.com/cloudflare/cloudflare-python/commit/9e18f39e933b396a425b0a3f6976a1130e7218c2))
+* **readme:** fix version rendering on pypi ([d3d7dd6](https://github.com/cloudflare/cloudflare-python/commit/d3d7dd61af8899c760d066d53c69e5b0e4e99fe8))
+* **tests:** skip some failing tests on the latest python versions ([dbbb02d](https://github.com/cloudflare/cloudflare-python/commit/dbbb02d2077911a1eac2069ac1e82b54e2ae5b1b))
+
+
+### Documentation
+
+* **client:** fix httpx.Timeout documentation reference ([0114564](https://github.com/cloudflare/cloudflare-python/commit/0114564d5cfb8459f19fe3dd80ce6e55617096ec))
+
 ## 4.3.1 (2025-06-16)
 
 Full Changelog: [v4.3.0...v4.3.1](https://github.com/cloudflare/cloudflare-python/compare/v4.3.0...v4.3.1)

README.md

@@ -1,6 +1,7 @@
 # Cloudflare Python API library
 
-[![PyPI version](https://img.shields.io/pypi/v/cloudflare.svg)](https://pypi.org/project/cloudflare/)
+<!-- prettier-ignore -->
+[![PyPI version](https://img.shields.io/pypi/v/cloudflare.svg?label=pypi%20(stable))](https://pypi.org/project/cloudflare/)
 
 The Cloudflare Python library provides convenient access to the Cloudflare REST API from any Python 3.8+
 application. The library includes type definitions for all request params and response fields,
@@ -70,6 +71,41 @@ asyncio.run(main())
 
 Functionality between the synchronous and asynchronous clients is otherwise identical.
 
+### With aiohttp
+
+By default, the async client uses `httpx` for HTTP requests. However, for improved concurrency performance you may also use `aiohttp` as the HTTP backend.
+
+You can enable this by installing `aiohttp`:
+
+```sh
+# install from PyPI
+pip install cloudflare[aiohttp]
+```
+
+Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
+
+```python
+import asyncio
+from cloudflare import DefaultAioHttpClient
+from cloudflare import AsyncCloudflare
+
+
+async def main() -> None:
+    async with AsyncCloudflare(
+        api_token="Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY",
+        http_client=DefaultAioHttpClient(),
+    ) as client:
+        zone = await client.zones.create(
+            account={"id": "023e105f4ecef8ad9ca31a8372d0c353"},
+            name="example.com",
+            type="full",
+        )
+        print(zone.id)
+
+
+asyncio.run(main())
+```
+
 ## Using types
 
 Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict). Responses are [Pydantic models](https://docs.pydantic.dev) which also provide helper methods for things like:
@@ -244,7 +280,7 @@ client.with_options(max_retries=5).zones.get(
 ### Timeouts
 
 By default requests time out after 1 minute. You can configure this with a `timeout` option,
-which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
+which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
 from cloudflare import Cloudflare