feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 139
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-87e16688d40cde735bc36efd40d8c12a7918919b18268d9c40b46d0cdf2f6251.yml
-openapi_spec_hash: 83f1f5a6fa7a07db4af09426232d0786
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-d6a851f21804170f796637f1911c3382f1c57f5ed6b9b77cd7d0c6f74c06e174.yml
+openapi_spec_hash: 82df33badf54d0c7087a61145d379f58
 config_hash: 3279841440b02d4e8303c961d6983492

src/orb/resources/alerts.py

@@ -18,7 +18,7 @@
     alert_create_for_subscription_params,
     alert_create_for_external_customer_params,
 )
-from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from .._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -353,7 +353,9 @@ def create_for_subscription(
         *,
         thresholds: Iterable[ThresholdParam],
         type: Literal["usage_exceeded", "cost_exceeded"],
+        grouping_keys: Optional[SequenceNotStr[str]] | Omit = omit,
         metric_id: Optional[str] | Omit = omit,
+        pricing_unit_id: Optional[str] | Omit = omit,
         # 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,
@@ -380,8 +382,14 @@ def create_for_subscription(
 
           type: The type of alert to create. This must be a valid alert type.
 
+          grouping_keys: The property keys to group cost alerts by. Only applicable for cost_exceeded
+              alerts.
+
           metric_id: The metric to track usage for.
 
+          pricing_unit_id: The pricing unit to use for grouped cost alerts. Required when grouping_keys is
+              set.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -400,7 +408,9 @@ def create_for_subscription(
                 {
                     "thresholds": thresholds,
                     "type": type,
+                    "grouping_keys": grouping_keys,
                     "metric_id": metric_id,
+                    "pricing_unit_id": pricing_unit_id,
                 },
                 alert_create_for_subscription_params.AlertCreateForSubscriptionParams,
             ),
@@ -835,7 +845,9 @@ async def create_for_subscription(
         *,
         thresholds: Iterable[ThresholdParam],
         type: Literal["usage_exceeded", "cost_exceeded"],
+        grouping_keys: Optional[SequenceNotStr[str]] | Omit = omit,
         metric_id: Optional[str] | Omit = omit,
+        pricing_unit_id: Optional[str] | Omit = omit,
         # 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,
@@ -862,8 +874,14 @@ async def create_for_subscription(
 
           type: The type of alert to create. This must be a valid alert type.
 
+          grouping_keys: The property keys to group cost alerts by. Only applicable for cost_exceeded
+              alerts.
+
           metric_id: The metric to track usage for.
 
+          pricing_unit_id: The pricing unit to use for grouped cost alerts. Required when grouping_keys is
+              set.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -882,7 +900,9 @@ async def create_for_subscription(
                 {
                     "thresholds": thresholds,
                     "type": type,
+                    "grouping_keys": grouping_keys,
                     "metric_id": metric_id,
+                    "pricing_unit_id": pricing_unit_id,
                 },
                 alert_create_for_subscription_params.AlertCreateForSubscriptionParams,
             ),

src/orb/types/alert.py

@@ -105,5 +105,11 @@ class Alert(BaseModel):
     This field is only present for credit balance alerts.
     """
 
+    grouping_keys: Optional[List[str]] = None
+    """The property keys to group cost alerts by.
+
+    Only present for cost alerts with grouping enabled.
+    """
+
     license_type: Optional[LicenseType] = None
     """Minified license type for alert serialization."""

src/orb/types/alert_create_for_subscription_params.py

@@ -5,6 +5,7 @@
 from typing import Iterable, Optional
 from typing_extensions import Literal, Required, TypedDict
 
+from .._types import SequenceNotStr
 from .threshold_param import ThresholdParam
 
 __all__ = ["AlertCreateForSubscriptionParams"]
@@ -17,5 +18,17 @@ class AlertCreateForSubscriptionParams(TypedDict, total=False):
     type: Required[Literal["usage_exceeded", "cost_exceeded"]]
     """The type of alert to create. This must be a valid alert type."""
 
+    grouping_keys: Optional[SequenceNotStr[str]]
+    """The property keys to group cost alerts by.
+
+    Only applicable for cost_exceeded alerts.
+    """
+
     metric_id: Optional[str]
     """The metric to track usage for."""
+
+    pricing_unit_id: Optional[str]
+    """The pricing unit to use for grouped cost alerts.
+
+    Required when grouping_keys is set.
+    """

tests/api_resources/test_alerts.py

@@ -274,7 +274,9 @@ def test_method_create_for_subscription_with_all_params(self, client: Orb) -> No
             subscription_id="subscription_id",
             thresholds=[{"value": 0}],
             type="usage_exceeded",
+            grouping_keys=["string"],
             metric_id="metric_id",
+            pricing_unit_id="pricing_unit_id",
         )
         assert_matches_type(Alert, alert, path=["response"])
 
@@ -670,7 +672,9 @@ async def test_method_create_for_subscription_with_all_params(self, async_client
             subscription_id="subscription_id",
             thresholds=[{"value": 0}],
             type="usage_exceeded",
+            grouping_keys=["string"],
             metric_id="metric_id",
+            pricing_unit_id="pricing_unit_id",
         )
         assert_matches_type(Alert, alert, path=["response"])