chore(api): update composite API spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 2184
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-1403422f70abb91a514423bbdf365693841543bca5451cab3dffed1848a8b94d.yml
-openapi_spec_hash: 4ec2396c0b2c3c933b0ae25961d580de
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-3d7d43f051a510c54ae71adb4b85cbb422565a40942cde4de0c3f8eb6ba8023b.yml
+openapi_spec_hash: e85824f16c3ba923a34e514c06dac7cd
 config_hash: af8ba8b08f4bcb84f6007acfbdc0671c

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

@@ -74,6 +74,7 @@ def list(
         *,
         account_id: str | None = None,
         name: str,
+        item_id: str | Omit = omit,
         metadata_filter: str | Omit = omit,
         page: int | Omit = omit,
         per_page: int | Omit = omit,
@@ -95,6 +96,8 @@ def list(
 
         Lowercase alphanumeric, hyphens, and underscores.
 
+          item_id: Filter items by their unique ID. Returns at most one item.
+
           metadata_filter:
               JSON-encoded metadata filter using Vectorize filter syntax. Examples:
               {"folder":"reports/"},
@@ -138,6 +141,7 @@ def list(
                 timeout=timeout,
                 query=maybe_transform(
                     {
+                        "item_id": item_id,
                         "metadata_filter": metadata_filter,
                         "page": page,
                         "per_page": per_page,
@@ -660,6 +664,7 @@ def list(
         *,
         account_id: str | None = None,
         name: str,
+        item_id: str | Omit = omit,
         metadata_filter: str | Omit = omit,
         page: int | Omit = omit,
         per_page: int | Omit = omit,
@@ -681,6 +686,8 @@ def list(
 
         Lowercase alphanumeric, hyphens, and underscores.
 
+          item_id: Filter items by their unique ID. Returns at most one item.
+
           metadata_filter:
               JSON-encoded metadata filter using Vectorize filter syntax. Examples:
               {"folder":"reports/"},
@@ -724,6 +731,7 @@ def list(
                 timeout=timeout,
                 query=maybe_transform(
                     {
+                        "item_id": item_id,
                         "metadata_filter": metadata_filter,
                         "page": page,
                         "per_page": per_page,

src/cloudflare/types/aisearch/namespaces/instances/item_list_params.py

@@ -12,6 +12,9 @@ class ItemListParams(TypedDict, total=False):
 
     name: Required[str]
 
+    item_id: str
+    """Filter items by their unique ID. Returns at most one item."""
+
     metadata_filter: str
     """JSON-encoded metadata filter using Vectorize filter syntax.
 

tests/api_resources/aisearch/namespaces/instances/test_items.py

@@ -50,6 +50,7 @@ def test_method_list_with_all_params(self, client: Cloudflare) -> None:
             id="my-ai-search",
             account_id="c3dc5f0b34a14ff8e1b3ec04895e1b22",
             name="my-namespace",
+            item_id="item_id",
             metadata_filter="metadata_filter",
             page=1,
             per_page=0,
@@ -777,6 +778,7 @@ async def test_method_list_with_all_params(self, async_client: AsyncCloudflare)
             id="my-ai-search",
             account_id="c3dc5f0b34a14ff8e1b3ec04895e1b22",
             name="my-namespace",
+            item_id="item_id",
             metadata_filter="metadata_filter",
             page=1,
             per_page=0,