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/orb-b13a08bfebe7b2efc4a5f8aa0b69015e2d58435a581b1578e3e67d76fdfb8cb0.yml
-openapi_spec_hash: bba0e6257d3d2f8612c5ad14b95839e2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb/orb-7f97a69f22372b818e8d24a72f6020bcf2f0c6d6b3ad07abb8395c87ec4a72ee.yml
+openapi_spec_hash: a6261e730c54d08ad36f1b946e663fc3
 config_hash: c01c1191b1cd696c7ca855ff6d28a8df

src/orb/resources/alerts.py

@@ -357,7 +357,9 @@ def create_for_subscription(
         type: Literal["usage_exceeded", "cost_exceeded"],
         grouping_keys: Optional[SequenceNotStr[str]] | Omit = omit,
         metric_id: Optional[str] | Omit = omit,
+        price_filters: Optional[Iterable[alert_create_for_subscription_params.PriceFilter]] | Omit = omit,
         pricing_unit_id: Optional[str] | Omit = omit,
+        threshold_overrides: Optional[Iterable[alert_create_for_subscription_params.ThresholdOverride]] | 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,
@@ -389,9 +391,19 @@ def create_for_subscription(
 
           metric_id: The metric to track usage for.
 
+          price_filters: Filters to scope which prices are included in grouped cost alert evaluation.
+              Supports filtering by price_id, item_id, or price_type with includes/excludes
+              operators. Only applicable when grouping_keys is set.
+
           pricing_unit_id: The pricing unit to use for grouped cost alerts. Required when grouping_keys is
               set.
 
+          threshold_overrides: Per-group threshold overrides. Each override maps a specific combination of
+              grouping_keys values to a list of thresholds that fully replaces the default
+              thresholds for that group. An empty thresholds list silences the group. Groups
+              without an override use the default thresholds. Only applicable when
+              grouping_keys is set.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -412,7 +424,9 @@ def create_for_subscription(
                     "type": type,
                     "grouping_keys": grouping_keys,
                     "metric_id": metric_id,
+                    "price_filters": price_filters,
                     "pricing_unit_id": pricing_unit_id,
+                    "threshold_overrides": threshold_overrides,
                 },
                 alert_create_for_subscription_params.AlertCreateForSubscriptionParams,
             ),
@@ -851,7 +865,9 @@ async def create_for_subscription(
         type: Literal["usage_exceeded", "cost_exceeded"],
         grouping_keys: Optional[SequenceNotStr[str]] | Omit = omit,
         metric_id: Optional[str] | Omit = omit,
+        price_filters: Optional[Iterable[alert_create_for_subscription_params.PriceFilter]] | Omit = omit,
         pricing_unit_id: Optional[str] | Omit = omit,
+        threshold_overrides: Optional[Iterable[alert_create_for_subscription_params.ThresholdOverride]] | 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,
@@ -883,9 +899,19 @@ async def create_for_subscription(
 
           metric_id: The metric to track usage for.
 
+          price_filters: Filters to scope which prices are included in grouped cost alert evaluation.
+              Supports filtering by price_id, item_id, or price_type with includes/excludes
+              operators. Only applicable when grouping_keys is set.
+
           pricing_unit_id: The pricing unit to use for grouped cost alerts. Required when grouping_keys is
               set.
 
+          threshold_overrides: Per-group threshold overrides. Each override maps a specific combination of
+              grouping_keys values to a list of thresholds that fully replaces the default
+              thresholds for that group. An empty thresholds list silences the group. Groups
+              without an override use the default thresholds. Only applicable when
+              grouping_keys is set.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -906,7 +932,9 @@ async def create_for_subscription(
                     "type": type,
                     "grouping_keys": grouping_keys,
                     "metric_id": metric_id,
+                    "price_filters": price_filters,
                     "pricing_unit_id": pricing_unit_id,
+                    "threshold_overrides": threshold_overrides,
                 },
                 alert_create_for_subscription_params.AlertCreateForSubscriptionParams,
             ),

src/orb/types/alert.py

@@ -9,7 +9,7 @@
 from .shared.customer_minified import CustomerMinified
 from .shared.subscription_minified import SubscriptionMinified
 
-__all__ = ["Alert", "Metric", "Plan", "BalanceAlertStatus", "LicenseType"]
+__all__ = ["Alert", "Metric", "Plan", "BalanceAlertStatus", "LicenseType", "PriceFilter", "ThresholdOverride"]
 
 
 class Metric(BaseModel):
@@ -51,6 +51,37 @@ class LicenseType(BaseModel):
     id: str
 
 
+class PriceFilter(BaseModel):
+    field: Literal["price_id", "item_id", "price_type", "currency", "pricing_unit_id"]
+    """The property of the price to filter on."""
+
+    operator: Literal["includes", "excludes"]
+    """Should prices that match the filter be included or excluded."""
+
+    values: List[str]
+    """The IDs or values that match this filter."""
+
+
+class ThresholdOverride(BaseModel):
+    """A per-group threshold override on a grouped cost alert.
+
+    An empty `thresholds` list means the group is silenced (never fires).
+    A non-empty list fully replaces the default thresholds for that group.
+    """
+
+    group_values: List[str]
+    """The values of the grouping keys that identify this group.
+
+    The list length matches the alert's grouping_keys.
+    """
+
+    thresholds: List[Threshold]
+    """The thresholds applied to this group.
+
+    An empty list means the group is silenced.
+    """
+
+
 class Alert(BaseModel):
     """
     [Alerts within Orb](/product-catalog/configuring-alerts) monitor spending,
@@ -113,3 +144,14 @@ class Alert(BaseModel):
 
     license_type: Optional[LicenseType] = None
     """Minified license type for alert serialization."""
+
+    price_filters: Optional[List[PriceFilter]] = None
+    """Filters scoping which prices are included in grouped cost alert evaluation."""
+
+    threshold_overrides: Optional[List[ThresholdOverride]] = None
+    """Per-group threshold overrides.
+
+    Each override maps a specific combination of grouping_keys values to a
+    replacement threshold list. Only present for grouped cost alerts that have at
+    least one override.
+    """

src/orb/types/alert_create_for_subscription_params.py

@@ -8,7 +8,7 @@
 from .._types import SequenceNotStr
 from .threshold_param import ThresholdParam
 
-__all__ = ["AlertCreateForSubscriptionParams"]
+__all__ = ["AlertCreateForSubscriptionParams", "PriceFilter", "ThresholdOverride"]
 
 
 class AlertCreateForSubscriptionParams(TypedDict, total=False):
@@ -27,8 +27,57 @@ class AlertCreateForSubscriptionParams(TypedDict, total=False):
     metric_id: Optional[str]
     """The metric to track usage for."""
 
+    price_filters: Optional[Iterable[PriceFilter]]
+    """Filters to scope which prices are included in grouped cost alert evaluation.
+
+    Supports filtering by price_id, item_id, or price_type with includes/excludes
+    operators. Only applicable when grouping_keys is set.
+    """
+
     pricing_unit_id: Optional[str]
     """The pricing unit to use for grouped cost alerts.
 
     Required when grouping_keys is set.
     """
+
+    threshold_overrides: Optional[Iterable[ThresholdOverride]]
+    """Per-group threshold overrides.
+
+    Each override maps a specific combination of grouping_keys values to a list of
+    thresholds that fully replaces the default thresholds for that group. An empty
+    thresholds list silences the group. Groups without an override use the default
+    thresholds. Only applicable when grouping_keys is set.
+    """
+
+
+class PriceFilter(TypedDict, total=False):
+    field: Required[Literal["price_id", "item_id", "price_type", "currency", "pricing_unit_id"]]
+    """The property of the price to filter on."""
+
+    operator: Required[Literal["includes", "excludes"]]
+    """Should prices that match the filter be included or excluded."""
+
+    values: Required[SequenceNotStr[str]]
+    """The IDs or values that match this filter."""
+
+
+class ThresholdOverride(TypedDict, total=False):
+    """Per-group threshold override on a grouped cost alert.
+
+    - An empty `thresholds` list silences alerts for this group (never fires).
+    - A non-empty list fully replaces the default thresholds for this group.
+    """
+
+    group_values: Required[SequenceNotStr[str]]
+    """The values of the grouping keys that identify this group.
+
+    The list length must match the alert's grouping_keys, and values appear in the
+    same order as grouping_keys.
+    """
+
+    thresholds: Required[Iterable[ThresholdParam]]
+    """The thresholds to apply to this group.
+
+    An empty list silences alerts for this group. A non-empty list fully replaces
+    the default thresholds for this group.
+    """

tests/api_resources/test_alerts.py

@@ -276,7 +276,20 @@ def test_method_create_for_subscription_with_all_params(self, client: Orb) -> No
             type="usage_exceeded",
             grouping_keys=["string"],
             metric_id="metric_id",
+            price_filters=[
+                {
+                    "field": "price_id",
+                    "operator": "includes",
+                    "values": ["string"],
+                }
+            ],
             pricing_unit_id="pricing_unit_id",
+            threshold_overrides=[
+                {
+                    "group_values": ["string"],
+                    "thresholds": [{"value": 0}],
+                }
+            ],
         )
         assert_matches_type(Alert, alert, path=["response"])
 
@@ -674,7 +687,20 @@ async def test_method_create_for_subscription_with_all_params(self, async_client
             type="usage_exceeded",
             grouping_keys=["string"],
             metric_id="metric_id",
+            price_filters=[
+                {
+                    "field": "price_id",
+                    "operator": "includes",
+                    "values": ["string"],
+                }
+            ],
             pricing_unit_id="pricing_unit_id",
+            threshold_overrides=[
+                {
+                    "group_values": ["string"],
+                    "thresholds": [{"value": 0}],
+                }
+            ],
         )
         assert_matches_type(Alert, alert, path=["response"])