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 }}

.gitignore

@@ -1,5 +1,4 @@
 .prism.log
-.vscode
 _dev
 
 __pycache__

.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: 1783
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-e408a7cdec2dae3d1a18842dcc59280c56050fb042569139aec3fe0f12e0d461.yml
+openapi_spec_hash: 7e210c76f5dd4c79b3e67204ad279b81
+config_hash: 1d1f62e87686c0d8571be460876f347c

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "python.analysis.importFormat": "relative",
+}

CHANGELOG.md

@@ -1,5 +1,102 @@
 # Changelog
 
+## 4.4.0 (2025-08-02)
+
+Full Changelog: [v4.3.1...v4.4.0](https://github.com/cloudflare/cloudflare-python/compare/v4.3.1...v4.4.0)
+
+### Features
+
+* **api:** api update ([4f45fd3](https://github.com/cloudflare/cloudflare-python/commit/4f45fd34ff28ffc24a0dd6e184e84cb9e600048b))
+* **api:** api update ([1a01a4c](https://github.com/cloudflare/cloudflare-python/commit/1a01a4cef3884c2342cc9fc3091f15f175c10f64))
+* **api:** api update ([0ea1719](https://github.com/cloudflare/cloudflare-python/commit/0ea1719087ab998f84f42b4531a31ac211fc499a))
+* **api:** api update ([e0e13d1](https://github.com/cloudflare/cloudflare-python/commit/e0e13d1e05ee85b87e97a525ba226bc1e2978d61))
+* **api:** api update ([053f18f](https://github.com/cloudflare/cloudflare-python/commit/053f18f518d9a667b36a6787a9a098acda63ee16))
+* **api:** api update ([a51aa98](https://github.com/cloudflare/cloudflare-python/commit/a51aa985775acb99497a9c477d7dc09139c2aac9))
+* **api:** api update ([2528e34](https://github.com/cloudflare/cloudflare-python/commit/2528e345a3ba076ccbe8625662aa380616632332))
+* **api:** api update ([ff93fa7](https://github.com/cloudflare/cloudflare-python/commit/ff93fa75d4fb56cd32905f0b038b4bbf7f5461a7))
+* **api:** api update ([f36b1b3](https://github.com/cloudflare/cloudflare-python/commit/f36b1b337c568609dcb285729cdfd9ad645abf85))
+* **api:** api update ([f34ac3b](https://github.com/cloudflare/cloudflare-python/commit/f34ac3bd57d88ae4a7b85191191ab8681d47b85d))
+* **api:** api update ([798ad9b](https://github.com/cloudflare/cloudflare-python/commit/798ad9bbc747d55eddc313bcb44505d29bd54850))
+* **api:** api update ([da95a3c](https://github.com/cloudflare/cloudflare-python/commit/da95a3cd4f8964b00fba8ae4c1d92e9560d795d4))
+* **api:** api update ([9dc28ef](https://github.com/cloudflare/cloudflare-python/commit/9dc28ef7777e9ca06064d9a892c9090f162c0880))
+* **api:** api update ([6ddf7bd](https://github.com/cloudflare/cloudflare-python/commit/6ddf7bdcc9c35488d04d741bdeaea32d9fc3df87))
+* **api:** api update ([b607779](https://github.com/cloudflare/cloudflare-python/commit/b607779817e42a725f1829b6ae1bec472995d1fa))
+* **api:** api update ([d62a22f](https://github.com/cloudflare/cloudflare-python/commit/d62a22f109cbd7e17d03f635744d10b8bc62468b))
+* **api:** api update ([f180318](https://github.com/cloudflare/cloudflare-python/commit/f18031897607bed8160e374ad16f5e6fa44e9a6b))
+* **api:** api update ([1a667f2](https://github.com/cloudflare/cloudflare-python/commit/1a667f27d3339aac885d2c757a1805f16dbb7aee))
+* **api:** api update ([c7ead27](https://github.com/cloudflare/cloudflare-python/commit/c7ead27c8046a2be4bfc9f1ac3bb10b6845fe106))
+* **api:** api update ([f9de8af](https://github.com/cloudflare/cloudflare-python/commit/f9de8af04c3de32ba9749af92432545af3aed49f))
+* **api:** api update ([d0bc41a](https://github.com/cloudflare/cloudflare-python/commit/d0bc41a0c0a45911045c66543f66aebd66d7da2e))
+* **api:** api update ([0925597](https://github.com/cloudflare/cloudflare-python/commit/0925597d91bfb6c529426f41d023be7f8b97ffd3))
+* **api:** api update ([5745f74](https://github.com/cloudflare/cloudflare-python/commit/5745f74557e1289536cb11fa6e701411b2621066))
+* **api:** api update ([1a935f1](https://github.com/cloudflare/cloudflare-python/commit/1a935f11a343cca19171cf5de8c38f58856ae738))
+* **api:** api update ([54d6d21](https://github.com/cloudflare/cloudflare-python/commit/54d6d217d4f3b8ae2b87db2eb426819839f38315))
+* **api:** api update ([ae7588d](https://github.com/cloudflare/cloudflare-python/commit/ae7588d0b75a63f629fe304f434c616d521b5f3d))
+* **api:** api update ([7773d8a](https://github.com/cloudflare/cloudflare-python/commit/7773d8abc67e3a475fe2cd7c73301f3e9c7044bb))
+* **api:** api update ([d43aff4](https://github.com/cloudflare/cloudflare-python/commit/d43aff4a49f54e2b66cd1cf173a1bbbbd67e9de6))
+* **api:** api update ([90035b1](https://github.com/cloudflare/cloudflare-python/commit/90035b1ef5df466e26f5569005042342f34685a4))
+* **api:** api update ([4b25769](https://github.com/cloudflare/cloudflare-python/commit/4b2576975390342d64a58d6181e8a3f77f58e7b0))
+* **api:** api update ([4ab783f](https://github.com/cloudflare/cloudflare-python/commit/4ab783f798c1d2ac041afe9cc0f1829131a4cbba))
+* **api:** api update ([094a1c0](https://github.com/cloudflare/cloudflare-python/commit/094a1c0f2481b8e41ad5f06c12ada4d22776299f))
+* **api:** api update ([0084a4d](https://github.com/cloudflare/cloudflare-python/commit/0084a4d643e56ef69978eb3868b73beb4e9c24e2))
+* **api:** api update ([1bea8ae](https://github.com/cloudflare/cloudflare-python/commit/1bea8ae838936eab4da1b81092e6a184d4cbee38))
+* **api:** api update ([ad06dcd](https://github.com/cloudflare/cloudflare-python/commit/ad06dcd9de8fa91a2876359c865fd3441c7efee5))
+* **api:** api update ([b9c025b](https://github.com/cloudflare/cloudflare-python/commit/b9c025b2745b45eb9d4ce743dd4d4131d0b9034b))
+* **api:** api update ([20da11a](https://github.com/cloudflare/cloudflare-python/commit/20da11a728f7581238769b01e9b6dce525d7e235))
+* **api:** api update ([aef7eb7](https://github.com/cloudflare/cloudflare-python/commit/aef7eb77a0565f001bcef1d28e1adddcbdcda821))
+* **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))
+* clean up environment call outs ([f24f43d](https://github.com/cloudflare/cloudflare-python/commit/f24f43d8132d0efc31d49954209549932bba6f75))
+* **client:** support file upload requests ([2bfa20a](https://github.com/cloudflare/cloudflare-python/commit/2bfa20a5ce735617e95729fa7f7e15e7b7aa34cc))
+
+
+### Bug Fixes
+
+* **api:** add missing `items` param ([f1eda00](https://github.com/cloudflare/cloudflare-python/commit/f1eda003cec7a593680d7e58106fad0e029cf5ee))
+* **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))
+* **parsing:** ignore empty metadata ([7569336](https://github.com/cloudflare/cloudflare-python/commit/7569336edf388157a87d85747180c925c9a4227a))
+* **parsing:** parse extra field types ([5c5c79d](https://github.com/cloudflare/cloudflare-python/commit/5c5c79d6d3d3601c38fc470d49d03d1e46716b7d))
+* radar types ([42c2209](https://github.com/cloudflare/cloudflare-python/commit/42c22098266df3dc6ebc0c19cfec97b6d851c9cd))
+* radar types ([234b609](https://github.com/cloudflare/cloudflare-python/commit/234b609b77d476c89f92fb289d02a1aaf6decf01))
+* **types:** add missing types ([8c44db9](https://github.com/cloudflare/cloudflare-python/commit/8c44db926c36c9734fcf7f07a7b82fc609f29297))
+
+
+### 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))
+* **api:** update composite API spec ([9cce5ac](https://github.com/cloudflare/cloudflare-python/commit/9cce5acde48c47ed3a59e5662ba87e8a38e83414))
+* **api:** upload OpenAPI schema from api-schemas ([be94ae0](https://github.com/cloudflare/cloudflare-python/commit/be94ae004837ec8e2c6fa132747a8378337ecb93))
+* **api:** upload stainless config from cloudflare-config ([da40430](https://github.com/cloudflare/cloudflare-python/commit/da40430abf95b44de17abbc172bcfb7477b08ec7))
+* **api:** upload stainless config from cloudflare-config ([cde1ea6](https://github.com/cloudflare/cloudflare-python/commit/cde1ea60050d99f02a275d3fb84625afd79154e7))
+* **api:** upload stainless config from cloudflare-config ([daa7fe0](https://github.com/cloudflare/cloudflare-python/commit/daa7fe0beca11ed9ba77bcf2d16a67ae9a8e83c0))
+* **api:** upload stainless config from cloudflare-config ([5d2c28c](https://github.com/cloudflare/cloudflare-python/commit/5d2c28c0fff36330feeacacbfa7039a5d3291e14))
+* **api:** upload stainless config from cloudflare-config ([8b866ab](https://github.com/cloudflare/cloudflare-python/commit/8b866ab3e5d548593a824fb4407fbacdd9a94fe0))
+* **api:** upload stainless config from cloudflare-config ([4456fdb](https://github.com/cloudflare/cloudflare-python/commit/4456fdb5bfc62a726f66f3705a3bddd8fc73407b))
+* **api:** upload stainless config from cloudflare-config ([d903656](https://github.com/cloudflare/cloudflare-python/commit/d903656ac46dffde681ddd97cdae697184e1c440))
+* **api:** upload stainless config from cloudflare-config ([f548ad4](https://github.com/cloudflare/cloudflare-python/commit/f548ad490f3f7d7b887a7c6691eae3234209f258))
+* **api:** upload stainless config from cloudflare-config ([0d5adaa](https://github.com/cloudflare/cloudflare-python/commit/0d5adaab4397dc11b3730304e796fb331102424b))
+* **api:** upload stainless config from cloudflare-config ([f47f76b](https://github.com/cloudflare/cloudflare-python/commit/f47f76b7499ed679f722ffcbfba3abafe77be702))
+* **api:** upload stainless config from cloudflare-config ([b0defd7](https://github.com/cloudflare/cloudflare-python/commit/b0defd7fef30a561cd1ce0adcf7444c3973d5bb8))
+* **api:** upload stainless config from cloudflare-config ([543a81b](https://github.com/cloudflare/cloudflare-python/commit/543a81b65159c05bef60ccf5d6dfd838fcfb6ca5))
+* **api:** upload stainless config from cloudflare-config ([e4b71d8](https://github.com/cloudflare/cloudflare-python/commit/e4b71d892d68eb6b6d491162e9b47f26b3407169))
+* **api:** upload stainless config from cloudflare-config ([c9fa067](https://github.com/cloudflare/cloudflare-python/commit/c9fa067b88ebeda085c44c2f014b8ee3c087e55a))
+* **api:** upload stainless config from cloudflare-config ([960e4e4](https://github.com/cloudflare/cloudflare-python/commit/960e4e4a5fd933107270c5808fc3ea45372a9de0))
+* **api:** upload stainless config from cloudflare-config ([d00a8be](https://github.com/cloudflare/cloudflare-python/commit/d00a8be88733a8a5aa1af3abdb942e47befc2b47))
+* **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))
+* **project:** add settings file for vscode ([967462d](https://github.com/cloudflare/cloudflare-python/commit/967462dfb5a37e4b7334fc0ce24c08abc37f3e62))
+* **readme:** fix version rendering on pypi ([d3d7dd6](https://github.com/cloudflare/cloudflare-python/commit/d3d7dd61af8899c760d066d53c69e5b0e4e99fe8))
+* **types:** rebuild Pydantic models after all types are defined ([cf574a4](https://github.com/cloudflare/cloudflare-python/commit/cf574a4c28ea55613d66da64bd55d89d1ffb8859))
+
 ## 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