Merge pull request #2707 from cloudflare/sync/staging-next-2026-04-29

sync: integrate staging-next codegen changes (2026-04-29)

Author: musa-cf

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 2194
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-0ce49e6bb0d3819f135b9a567b661205fdf5df21cff157eab2b7abd7b5b50347.yml
-openapi_spec_hash: 512a5bb3a32860590c8949765605d65a
-config_hash: 5367ae3e3a9a0d6578c2756965a99e3a
+configured_endpoints: 2195
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-a6c352830d1270d0abb5bb983058ea21815e1bb7d2e163965335dcb0e706f057.yml
+openapi_spec_hash: ffe469d5b0b3f29c20ccb91c0a2862e7
+config_hash: a83bae9f0be0219cfe77d38d5af60d4a

src/cloudflare/resources/ai/to_markdown.py

@@ -111,11 +111,11 @@ def transform(
         # sent to the server will contain a `boundary` parameter, e.g.
         # multipart/form-data; boundary=---abc--
         extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
-        return self._get_api_list(
+        return self._get_api_list(  # type: ignore[call-arg]
             path_template("/accounts/{account_id}/ai/tomarkdown", account_id=account_id),
             page=SyncSinglePage[ToMarkdownTransformResponse],
             body=maybe_transform(body, to_markdown_transform_params.ToMarkdownTransformParams),
-            files=files,
+            files=files,  # pyright: ignore[reportCallIssue]
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -210,11 +210,11 @@ def transform(
         # sent to the server will contain a `boundary` parameter, e.g.
         # multipart/form-data; boundary=---abc--
         extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
-        return self._get_api_list(
+        return self._get_api_list(  # type: ignore[call-arg]
             path_template("/accounts/{account_id}/ai/tomarkdown", account_id=account_id),
             page=AsyncSinglePage[ToMarkdownTransformResponse],
             body=maybe_transform(body, to_markdown_transform_params.ToMarkdownTransformParams),
-            files=files,
+            files=files,  # pyright: ignore[reportCallIssue]
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

src/cloudflare/resources/aisearch/instances/instances.py

@@ -192,7 +192,7 @@ def create(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceCreateResponse:
-        """Create a new instances.
+        """Create a new instance.
 
         Args:
           id: AI Search instance ID.
@@ -420,13 +420,10 @@ def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceUpdateResponse:
-        """Update instances.
+        """
+        Update instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           index_method: Controls which storage backends are used during indexing. Defaults to
               vector-only.
 
@@ -496,7 +493,7 @@ def list(
         self,
         *,
         account_id: str,
-        namespace: Optional[str] | Omit = omit,
+        namespace: str | Omit = omit,
         order_by: Literal["created_at"] | Omit = omit,
         order_by_direction: Literal["asc", "desc"] | Omit = omit,
         page: int | Omit = omit,
@@ -513,11 +510,17 @@ def list(
         List instances.
 
         Args:
-          order_by: Order By Column Name
+          namespace: Filter by namespace.
 
-          order_by_direction: Order By Direction
+          order_by: Field to order results by.
 
-          search: Search by id
+          order_by_direction: Order direction.
+
+          page: Page number (1-indexed).
+
+          per_page: Number of results per page.
+
+          search: Filter instances whose id contains this string (case-insensitive).
 
           extra_headers: Send extra headers
 
@@ -564,13 +567,10 @@ def delete(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceDeleteResponse:
-        """Delete instances.
+        """
+        Delete instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -693,13 +693,10 @@ def read(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceReadResponse:
-        """Read instances.
+        """
+        Read instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -969,7 +966,7 @@ async def create(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceCreateResponse:
-        """Create a new instances.
+        """Create a new instance.
 
         Args:
           id: AI Search instance ID.
@@ -1197,13 +1194,10 @@ async def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceUpdateResponse:
-        """Update instances.
+        """
+        Update instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           index_method: Controls which storage backends are used during indexing. Defaults to
               vector-only.
 
@@ -1273,7 +1267,7 @@ def list(
         self,
         *,
         account_id: str,
-        namespace: Optional[str] | Omit = omit,
+        namespace: str | Omit = omit,
         order_by: Literal["created_at"] | Omit = omit,
         order_by_direction: Literal["asc", "desc"] | Omit = omit,
         page: int | Omit = omit,
@@ -1290,11 +1284,17 @@ def list(
         List instances.
 
         Args:
-          order_by: Order By Column Name
+          namespace: Filter by namespace.
 
-          order_by_direction: Order By Direction
+          order_by: Field to order results by.
 
-          search: Search by id
+          order_by_direction: Order direction.
+
+          page: Page number (1-indexed).
+
+          per_page: Number of results per page.
+
+          search: Filter instances whose id contains this string (case-insensitive).
 
           extra_headers: Send extra headers
 
@@ -1341,13 +1341,10 @@ async def delete(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceDeleteResponse:
-        """Delete instances.
+        """
+        Delete instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1470,13 +1467,10 @@ async def read(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceReadResponse:
-        """Read instances.
+        """
+        Read instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request

src/cloudflare/resources/aisearch/namespaces/instances/instances.py

@@ -205,7 +205,7 @@ def create(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceCreateResponse:
-        """Create a new instances.
+        """Create a new instance.
 
         Args:
           id: AI Search instance ID.
@@ -438,13 +438,10 @@ def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceUpdateResponse:
-        """Update instances.
+        """
+        Update instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           index_method: Controls which storage backends are used during indexing. Defaults to
               vector-only.
 
@@ -522,7 +519,7 @@ def list(
         name: str,
         *,
         account_id: str,
-        namespace: Optional[str] | Omit = omit,
+        namespace: str | Omit = omit,
         order_by: Literal["created_at"] | Omit = omit,
         order_by_direction: Literal["asc", "desc"] | Omit = omit,
         page: int | Omit = omit,
@@ -539,11 +536,17 @@ def list(
         List instances.
 
         Args:
-          order_by: Order By Column Name
+          namespace: Filter by namespace.
 
-          order_by_direction: Order By Direction
+          order_by: Field to order results by.
 
-          search: Search by id
+          order_by_direction: Order direction.
+
+          page: Page number (1-indexed).
+
+          per_page: Number of results per page.
+
+          search: Filter instances whose id contains this string (case-insensitive).
 
           extra_headers: Send extra headers
 
@@ -595,13 +598,10 @@ def delete(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceDeleteResponse:
-        """Delete instances.
+        """
+        Delete instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -738,13 +738,10 @@ def read(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceReadResponse:
-        """Read instances.
+        """
+        Read instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1042,7 +1039,7 @@ async def create(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceCreateResponse:
-        """Create a new instances.
+        """Create a new instance.
 
         Args:
           id: AI Search instance ID.
@@ -1275,13 +1272,10 @@ async def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceUpdateResponse:
-        """Update instances.
+        """
+        Update instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           index_method: Controls which storage backends are used during indexing. Defaults to
               vector-only.
 
@@ -1359,7 +1353,7 @@ def list(
         name: str,
         *,
         account_id: str,
-        namespace: Optional[str] | Omit = omit,
+        namespace: str | Omit = omit,
         order_by: Literal["created_at"] | Omit = omit,
         order_by_direction: Literal["asc", "desc"] | Omit = omit,
         page: int | Omit = omit,
@@ -1376,11 +1370,17 @@ def list(
         List instances.
 
         Args:
-          order_by: Order By Column Name
+          namespace: Filter by namespace.
 
-          order_by_direction: Order By Direction
+          order_by: Field to order results by.
 
-          search: Search by id
+          order_by_direction: Order direction.
+
+          page: Page number (1-indexed).
+
+          per_page: Number of results per page.
+
+          search: Filter instances whose id contains this string (case-insensitive).
 
           extra_headers: Send extra headers
 
@@ -1432,13 +1432,10 @@ async def delete(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceDeleteResponse:
-        """Delete instances.
+        """
+        Delete instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1575,13 +1572,10 @@ async def read(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> InstanceReadResponse:
-        """Read instances.
+        """
+        Read instance.
 
         Args:
-          id: AI Search instance ID.
-
-        Lowercase alphanumeric, hyphens, and underscores.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request