cloudflare · stainless-app · Jul 31, 2025 · Jul 31, 2025 · Jul 31, 2025 · Aug 1, 2025
diff --git a/.github/workflows/ci.yml b/.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,24 +40,40 @@ jobs:
       - name: Run lints
         run: ./scripts/lint
 
-  upload:
-    if: github.repository == 'stainless-sdks/cloudflare-python'
+  build:
+    if: 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
+        if: github.repository == 'stainless-sdks/cloudflare-python'
         id: github-oidc
         uses: actions/github-script@v6
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
       - name: Upload tarball
+        if: github.repository == 'stainless-sdks/cloudflare-python'
         env:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}
@@ -63,6 +84,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 +106,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

diff --git a/.github/workflows/detect-breaking-changes.yml b/.github/workflows/detect-breaking-changes.yml
@@ -0,0 +1,42 @@
+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 removed symbols
+        run: |
+          rye run python scripts/detect-breaking-changes.py "${{ github.event.pull_request.base.sha }}"
+
+      - name: Detect breaking changes
+        run: |
+          # Try to check out previous versions of the breaking change detection script. This ensures that
+          # we still detect breaking changes when entire files and their tests are removed.
+          git checkout "${{ github.event.pull_request.base.sha }}" -- ./scripts/detect-breaking-changes 2>/dev/null || true
+          ./scripts/detect-breaking-changes ${{ github.event.pull_request.base.sha }}
diff --git a/.gitignore b/.gitignore
@@ -1,5 +1,4 @@
 .prism.log
-.vscode
 _dev
 
 __pycache__

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "4.3.1"
+  ".": "4.4.0"
 }
diff --git a/.stats.yml b/.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: 1798
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-c972b67141d4322a331c3f8191fd859e88c23d0528b1e8daac86c49521cd3510.yml
+openapi_spec_hash: 55643b37c147c204b6b0d70c3e99a6b6
+config_hash: a1304617cd14c003fb430a6827269eba
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,3 @@
+{
+    "python.analysis.importFormat": "relative",
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,94 @@
 # Changelog
 
+## 4.4.0 (2025-08-21)
+
+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 ([9505003](https://github.com/cloudflare/cloudflare-python/commit/950500376cf65b62595b832fbb1aabb9a7f01240))
+* **api:** api update ([f59cd16](https://github.com/cloudflare/cloudflare-python/commit/f59cd16fd49f26967ede3f790ab71dbe63307a44))
+* **api:** api update ([ecddba4](https://github.com/cloudflare/cloudflare-python/commit/ecddba47c9009d50996e0dc20d1abec160b1e385))
+* **api:** api update ([e3e1940](https://github.com/cloudflare/cloudflare-python/commit/e3e1940e4b0def7eb16b6dac4568dd73594f9420))
+* **api:** api update ([2bf7ec6](https://github.com/cloudflare/cloudflare-python/commit/2bf7ec640e0cb0e3d809b37b58a429794b12d617))
+* **api:** api update ([6b38219](https://github.com/cloudflare/cloudflare-python/commit/6b38219e064393068404b17eb36799e4921d16c9))
+* **api:** api update ([9a383ab](https://github.com/cloudflare/cloudflare-python/commit/9a383aba94cbfd597107abf58979ce946d72b9a1))
+* **api:** api update ([78034ba](https://github.com/cloudflare/cloudflare-python/commit/78034ba1680989c16fba7c47599d1d4dbe76e843))
+* **api:** api update ([b115142](https://github.com/cloudflare/cloudflare-python/commit/b115142726fafa5d1f77d4da0751b07e05d569ea))
+* **api:** api update ([af66067](https://github.com/cloudflare/cloudflare-python/commit/af66067fdbc10da9ca865c75c2ca2760a9c870ec))
+* **api:** api update ([2439e6f](https://github.com/cloudflare/cloudflare-python/commit/2439e6fef1cf995510c5d90e598455e3a54a6b95))
+* **api:** api update ([9e35d23](https://github.com/cloudflare/cloudflare-python/commit/9e35d237a01bc6530dd6667c2f51879e282e1e63))
+* **api:** api update ([c3f510c](https://github.com/cloudflare/cloudflare-python/commit/c3f510c0602e4756e907991fa933f8fd14602d7f))
+* **api:** api update ([8570679](https://github.com/cloudflare/cloudflare-python/commit/85706796ecb7e7107b072c9bfcaf7a45d30b51d5))
+* **api:** api update ([a6720f5](https://github.com/cloudflare/cloudflare-python/commit/a6720f52cd03b6aefd8cfb3450fe64062c34405e))
+* **api:** api update ([e4f6db1](https://github.com/cloudflare/cloudflare-python/commit/e4f6db131b8c4c0ce3125fa8a76fe1ec0ecfbae9))
+* **api:** api update ([b20d895](https://github.com/cloudflare/cloudflare-python/commit/b20d89591b9e8090948a76c745a5cdbb7e00267a))
+* **api:** api update ([e449e47](https://github.com/cloudflare/cloudflare-python/commit/e449e47e8a68b54ca5ea09b868c40cdecd3e15c7))
+* **api:** api update ([3b9ea5d](https://github.com/cloudflare/cloudflare-python/commit/3b9ea5d0c69edfe53123243b927e096f1157e88a))
+* **api:** api update ([9fff7a0](https://github.com/cloudflare/cloudflare-python/commit/9fff7a0346574783ea17c6bd459f9a58a039c584))
+* **api:** api update ([9f1f4b0](https://github.com/cloudflare/cloudflare-python/commit/9f1f4b0c08551204165be1560cdd1b3091037a8e))
+* **api:** api update ([5698cb6](https://github.com/cloudflare/cloudflare-python/commit/5698cb6425b2b3c689aac42e6a474083e16c688d))
+* **api:** api update ([5662a87](https://github.com/cloudflare/cloudflare-python/commit/5662a87c01b857d54338e3ccff69474d2c14b491))
+* **api:** api update ([dd641c8](https://github.com/cloudflare/cloudflare-python/commit/dd641c805298a6e7545f49fde23d9dbc82d006cc))
+* **api:** api update ([4a19fdc](https://github.com/cloudflare/cloudflare-python/commit/4a19fdc85d0fadb23837fe13b3aaefbca6adc72a))
+* **api:** api update ([1e44790](https://github.com/cloudflare/cloudflare-python/commit/1e44790622257efd20e23b4a0e30bf4d4fe29ebc))
+* **api:** api update ([6409e1c](https://github.com/cloudflare/cloudflare-python/commit/6409e1c4d9b04fdfe03ad5197ccdf48d647c2510))
+* **api:** api update ([33b5aba](https://github.com/cloudflare/cloudflare-python/commit/33b5abaddae6d5139bd7ffffc2513e6a9d5b59d2))
+* **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))
+* **client:** support file upload requests ([2bfa20a](https://github.com/cloudflare/cloudflare-python/commit/2bfa20a5ce735617e95729fa7f7e15e7b7aa34cc))
+
+
+### Chores
+
+* **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 ([cb9ce20](https://github.com/cloudflare/cloudflare-python/commit/cb9ce202d226e30e1ef7fa033b74c2e37db1682a))
+* **api:** upload stainless config from cloudflare-config ([04b69f3](https://github.com/cloudflare/cloudflare-python/commit/04b69f322eae243c963540a5d9bed1c462c26e44))
+* **api:** upload stainless config from cloudflare-config ([0962510](https://github.com/cloudflare/cloudflare-python/commit/096251086c13e2e03de5f4ea17da5cfa3b271c3f))
+* **api:** upload stainless config from cloudflare-config ([91a8f60](https://github.com/cloudflare/cloudflare-python/commit/91a8f6028e0a24f600b8aa0dac183fa7bb40ee6a))
+* **api:** upload stainless config from cloudflare-config ([7477489](https://github.com/cloudflare/cloudflare-python/commit/74774897bf9f410ea8a9cc17e9ae2b1890f6a2d0))
+* **api:** upload stainless config from cloudflare-config ([cadee02](https://github.com/cloudflare/cloudflare-python/commit/cadee02a6b85c5973f3ecdc6b2d9f36466bef915))
+* **api:** upload stainless config from cloudflare-config ([f6cb2e1](https://github.com/cloudflare/cloudflare-python/commit/f6cb2e1a3a0df41f786b2cd9fa10426b9e5d6328))
+* **api:** upload stainless config from cloudflare-config ([649bc99](https://github.com/cloudflare/cloudflare-python/commit/649bc9915fb21e3b35ad7d5664c1893b1e55c3c1))
+* **api:** upload stainless config from cloudflare-config ([6cbf008](https://github.com/cloudflare/cloudflare-python/commit/6cbf008e22076e1a5b00a422c11e3fa000a324c1))
+* **api:** upload stainless config from cloudflare-config ([fcff175](https://github.com/cloudflare/cloudflare-python/commit/fcff1758c1e91d6f9ad3b91914395e664f629dcf))
+* **api:** upload stainless config from cloudflare-config ([c019dae](https://github.com/cloudflare/cloudflare-python/commit/c019dae16f08a5e964e9c9ad27e8013afbfdb52c))
+* **api:** upload stainless config from cloudflare-config ([1e499f3](https://github.com/cloudflare/cloudflare-python/commit/1e499f38ecbdf0398bf5143db2200952ff07adc3))
+* **api:** upload stainless config from cloudflare-config ([6464b31](https://github.com/cloudflare/cloudflare-python/commit/6464b318e163995e744c6d59064cc8d912835230))
+* **api:** upload stainless config from cloudflare-config ([6a1b4d4](https://github.com/cloudflare/cloudflare-python/commit/6a1b4d4184d20adf92b05d65752ecd9d5218972a))
+* **api:** upload stainless config from cloudflare-config ([9f4226d](https://github.com/cloudflare/cloudflare-python/commit/9f4226de0aac877922578b036ac6502add00c651))
+* **api:** upload stainless config from cloudflare-config ([dc18093](https://github.com/cloudflare/cloudflare-python/commit/dc180939633e6568ea205ff993b07265464f082a))
+* **api:** upload stainless config from cloudflare-config ([a4b55b1](https://github.com/cloudflare/cloudflare-python/commit/a4b55b1fe9212b25ea2e808b07379e05c686fe15))
+* **api:** upload stainless config from cloudflare-config ([e122304](https://github.com/cloudflare/cloudflare-python/commit/e1223043f114cf951ea24a0b02b84955bd34eb8c))
+* **api:** upload stainless config from cloudflare-config ([a59205e](https://github.com/cloudflare/cloudflare-python/commit/a59205e5050482174638115ed556bb9cfe755263))
+* **api:** upload stainless config from cloudflare-config ([a27e50c](https://github.com/cloudflare/cloudflare-python/commit/a27e50c312aba0763fbbd8f69122885acc73ae9e))
+* **api:** upload stainless config from cloudflare-config ([23052e9](https://github.com/cloudflare/cloudflare-python/commit/23052e9bac88c1bebcedf30eba913d1ab20413d3))
+* **api:** upload stainless config from cloudflare-config ([e929abc](https://github.com/cloudflare/cloudflare-python/commit/e929abc72b667908ec15f920846510f3d403430c))
+* **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))
+* **internal:** detect breaking changes when removing endpoints ([cf3a21e](https://github.com/cloudflare/cloudflare-python/commit/cf3a21edb663b92b610352ea292f0ba0cb7d8bb5))
+* **internal:** fix ruff target version ([88f5280](https://github.com/cloudflare/cloudflare-python/commit/88f5280930375959c8d89bb512008b9a99731e74))
+* **internal:** improve breaking change detection ([4bdc67a](https://github.com/cloudflare/cloudflare-python/commit/4bdc67a69bc45effb37a7acaa67f76f29a60a484))
+* **internal:** update comment in script ([8f64f5f](https://github.com/cloudflare/cloudflare-python/commit/8f64f5f49b53a35b5d568ef7eb7e344acc463865))
+* update @stainless-api/prism-cli to v5.15.0 ([a1e726e](https://github.com/cloudflare/cloudflare-python/commit/a1e726e0336c44efea0368dfaeb5aeb9a6965a02))
+* update github action ([3a35ffd](https://github.com/cloudflare/cloudflare-python/commit/3a35ffddc79e5520fd5f77d0ae8b19509b8cfabb))
+
 ## 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)

diff --git a/README.md b/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