feat(api): update item endpoint (#287)

feat(api): pricing model updates

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
-configured_endpoints: 89
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb-518a2c5acac4b9a7da39e27435ec6e8a3f494703a33627e3d726395e03e9b7f2.yml
+configured_endpoints: 90
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb-a6a1b7ffd49d131bfc4a1e8e508ac1fe23875c64b27c99f97dd4df06ea5e3ff5.yml

api.md

@@ -245,6 +245,7 @@ from orb.types import Item
 Methods:
 
 - <code title="post /items">client.items.<a href="./src/orb/resources/items.py">create</a>(\*\*<a href="src/orb/types/item_create_params.py">params</a>) -> <a href="./src/orb/types/item.py">Item</a></code>
+- <code title="put /items/{item_id}">client.items.<a href="./src/orb/resources/items.py">update</a>(item_id, \*\*<a href="src/orb/types/item_update_params.py">params</a>) -> <a href="./src/orb/types/item.py">Item</a></code>
 - <code title="get /items">client.items.<a href="./src/orb/resources/items.py">list</a>(\*\*<a href="src/orb/types/item_list_params.py">params</a>) -> <a href="./src/orb/types/item.py">SyncPage[Item]</a></code>
 - <code title="get /items/{item_id}">client.items.<a href="./src/orb/resources/items.py">fetch</a>(item_id) -> <a href="./src/orb/types/item.py">Item</a></code>
 

src/orb/resources/items.py

@@ -2,12 +2,12 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Dict, Iterable, Optional
 
 import httpx
 
 from .. import _legacy_response
-from ..types import item_list_params, item_create_params
+from ..types import item_list_params, item_create_params, item_update_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
 from .._utils import (
     maybe_transform,
@@ -76,6 +76,60 @@ def create(
             cast_to=Item,
         )
 
+    def update(
+        self,
+        item_id: str,
+        *,
+        external_connections: Optional[Iterable[item_update_params.ExternalConnection]],
+        metadata: Optional[Dict[str, Optional[str]]] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
+    ) -> Item:
+        """Update items
+
+        Args:
+          metadata: User-specified key/value pairs for the resource.
+
+        Individual keys can be removed
+              by setting the value to `null`, and the entire metadata mapping can be cleared
+              by setting `metadata` to `null`.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not item_id:
+            raise ValueError(f"Expected a non-empty value for `item_id` but received {item_id!r}")
+        return self._put(
+            f"/items/{item_id}",
+            body=maybe_transform(
+                {
+                    "external_connections": external_connections,
+                    "metadata": metadata,
+                },
+                item_update_params.ItemUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=Item,
+        )
+
     def list(
         self,
         *,
@@ -209,6 +263,60 @@ async def create(
             cast_to=Item,
         )
 
+    async def update(
+        self,
+        item_id: str,
+        *,
+        external_connections: Optional[Iterable[item_update_params.ExternalConnection]],
+        metadata: Optional[Dict[str, Optional[str]]] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
+    ) -> Item:
+        """Update items
+
+        Args:
+          metadata: User-specified key/value pairs for the resource.
+
+        Individual keys can be removed
+              by setting the value to `null`, and the entire metadata mapping can be cleared
+              by setting `metadata` to `null`.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not item_id:
+            raise ValueError(f"Expected a non-empty value for `item_id` but received {item_id!r}")
+        return await self._put(
+            f"/items/{item_id}",
+            body=await async_maybe_transform(
+                {
+                    "external_connections": external_connections,
+                    "metadata": metadata,
+                },
+                item_update_params.ItemUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=Item,
+        )
+
     def list(
         self,
         *,
@@ -299,6 +407,9 @@ def __init__(self, items: Items) -> None:
         self.create = _legacy_response.to_raw_response_wrapper(
             items.create,
         )
+        self.update = _legacy_response.to_raw_response_wrapper(
+            items.update,
+        )
         self.list = _legacy_response.to_raw_response_wrapper(
             items.list,
         )
@@ -314,6 +425,9 @@ def __init__(self, items: AsyncItems) -> None:
         self.create = _legacy_response.async_to_raw_response_wrapper(
             items.create,
         )
+        self.update = _legacy_response.async_to_raw_response_wrapper(
+            items.update,
+        )
         self.list = _legacy_response.async_to_raw_response_wrapper(
             items.list,
         )
@@ -329,6 +443,9 @@ def __init__(self, items: Items) -> None:
         self.create = to_streamed_response_wrapper(
             items.create,
         )
+        self.update = to_streamed_response_wrapper(
+            items.update,
+        )
         self.list = to_streamed_response_wrapper(
             items.list,
         )
@@ -344,6 +461,9 @@ def __init__(self, items: AsyncItems) -> None:
         self.create = async_to_streamed_response_wrapper(
             items.create,
         )
+        self.update = async_to_streamed_response_wrapper(
+            items.update,
+        )
         self.list = async_to_streamed_response_wrapper(
             items.list,
         )