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-77e112caf7b2a2c7b0248b7245b5730bc72ab0ea84ba5d0777e7d0604ae04d26.yml
-openapi_spec_hash: 966568dd08f34db64ba0ebace678268a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-3c7ee3ec9931aaeeb5e015a598812cde9edc09f114adb8759ef4c2054c90f7dc.yml
+openapi_spec_hash: a14720041156fe4f353449142edacf0d
 config_hash: 3279841440b02d4e8303c961d6983492

src/orb/resources/prices/prices.py

@@ -3503,6 +3503,7 @@ def evaluate(
         external_customer_id: Optional[str] | Omit = omit,
         filter: Optional[str] | Omit = omit,
         grouping_keys: SequenceNotStr[str] | Omit = omit,
+        metric_parameter_overrides: Optional[Dict[str, object]] | 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,
@@ -3555,6 +3556,9 @@ def evaluate(
               [computed properties](/extensibility/advanced-metrics#computed-properties)) used
               to group the underlying billable metric
 
+          metric_parameter_overrides: Optional overrides for parameterized billable metric parameters. If the metric
+              has parameter definitions and no overrides are provided, defaults will be used.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -3577,6 +3581,7 @@ def evaluate(
                     "external_customer_id": external_customer_id,
                     "filter": filter,
                     "grouping_keys": grouping_keys,
+                    "metric_parameter_overrides": metric_parameter_overrides,
                 },
                 price_evaluate_params.PriceEvaluateParams,
             ),
@@ -7255,6 +7260,7 @@ async def evaluate(
         external_customer_id: Optional[str] | Omit = omit,
         filter: Optional[str] | Omit = omit,
         grouping_keys: SequenceNotStr[str] | Omit = omit,
+        metric_parameter_overrides: Optional[Dict[str, object]] | 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,
@@ -7307,6 +7313,9 @@ async def evaluate(
               [computed properties](/extensibility/advanced-metrics#computed-properties)) used
               to group the underlying billable metric
 
+          metric_parameter_overrides: Optional overrides for parameterized billable metric parameters. If the metric
+              has parameter definitions and no overrides are provided, defaults will be used.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -7329,6 +7338,7 @@ async def evaluate(
                     "external_customer_id": external_customer_id,
                     "filter": filter,
                     "grouping_keys": grouping_keys,
+                    "metric_parameter_overrides": metric_parameter_overrides,
                 },
                 price_evaluate_params.PriceEvaluateParams,
             ),

src/orb/types/billable_metric.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict, Optional
+from typing import Dict, List, Optional
 from typing_extensions import Literal
 
 from .item import Item
@@ -38,3 +38,5 @@ class BillableMetric(BaseModel):
     name: str
 
     status: Literal["active", "draft", "archived"]
+
+    parameter_definitions: Optional[List[Dict[str, object]]] = None

src/orb/types/price_evaluate_multiple_params.py

@@ -638,6 +638,13 @@ class PriceEvaluation(TypedDict, total=False):
     to group the underlying billable metric
     """
 
+    metric_parameter_overrides: Optional[Dict[str, object]]
+    """Optional overrides for parameterized billable metric parameters.
+
+    If the metric has parameter definitions and no overrides are provided, defaults
+    will be used.
+    """
+
     price: Optional[PriceEvaluationPrice]
     """New floating price request body params."""
 

src/orb/types/price_evaluate_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Union, Optional
+from typing import Dict, Union, Optional
 from datetime import datetime
 from typing_extensions import Required, Annotated, TypedDict
 
@@ -38,3 +38,10 @@ class PriceEvaluateParams(TypedDict, total=False):
     [computed properties](/extensibility/advanced-metrics#computed-properties)) used
     to group the underlying billable metric
     """
+
+    metric_parameter_overrides: Optional[Dict[str, object]]
+    """Optional overrides for parameterized billable metric parameters.
+
+    If the metric has parameter definitions and no overrides are provided, defaults
+    will be used.
+    """

src/orb/types/price_evaluate_preview_events_params.py

@@ -670,6 +670,13 @@ class PriceEvaluation(TypedDict, total=False):
     to group the underlying billable metric
     """
 
+    metric_parameter_overrides: Optional[Dict[str, object]]
+    """Optional overrides for parameterized billable metric parameters.
+
+    If the metric has parameter definitions and no overrides are provided, defaults
+    will be used.
+    """
+
     price: Optional[PriceEvaluationPrice]
     """New floating price request body params."""
 

src/orb/types/shared/price_interval.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Optional
+from typing import Dict, List, Optional
 from datetime import datetime
 
 from .price import Price
@@ -83,3 +83,9 @@ class PriceInterval(BaseModel):
     A list of customer IDs whose usage events will be aggregated and billed under
     this price interval.
     """
+
+    metric_parameter_overrides: Optional[Dict[str, object]] = None
+    """Override values for parameterized billable metric variables.
+
+    Keys are parameter names, values are the override values.
+    """

src/orb/types/subscription_create_params.py

@@ -1022,6 +1022,12 @@ class AddPrice(TypedDict, total=False):
     The subscription's maximum amount for this price.
     """
 
+    metric_parameter_overrides: Optional[Dict[str, object]]
+    """Override values for parameterized billable metric variables.
+
+    Keys are parameter names, values are the override values.
+    """
+
     minimum_amount: Optional[str]
     """[DEPRECATED] Use add_adjustments instead.
 
@@ -1788,6 +1794,12 @@ class ReplacePrice(TypedDict, total=False):
     The subscription's maximum amount for the replacement price.
     """
 
+    metric_parameter_overrides: Optional[Dict[str, object]]
+    """Override values for parameterized billable metric variables.
+
+    Keys are parameter names, values are the override values.
+    """
+
     minimum_amount: Optional[str]
     """[DEPRECATED] Use add_adjustments instead.
 

src/orb/types/subscription_price_intervals_params.py

@@ -729,6 +729,12 @@ class Add(TypedDict, total=False):
     billing period.
     """
 
+    metric_parameter_overrides: Optional[Dict[str, object]]
+    """Override values for parameterized billable metric variables.
+
+    Keys are parameter names, values are the override values (number or string).
+    """
+
     minimum_amount: Optional[float]
     """
     The minimum amount that will be billed for this price interval for a given
@@ -836,6 +842,12 @@ class Edit(TypedDict, total=False):
     on the price interval.
     """
 
+    metric_parameter_overrides: Optional[Dict[str, object]]
+    """Override values for parameterized billable metric variables.
+
+    Keys are parameter names, values are the override values (number or string).
+    """
+
     start_date: Annotated[Union[Union[str, datetime], BillingCycleRelativeDate], PropertyInfo(format="iso8601")]
     """The updated start date of this price interval.
 

src/orb/types/subscription_schedule_plan_change_params.py

@@ -1010,6 +1010,12 @@ class AddPrice(TypedDict, total=False):
     The subscription's maximum amount for this price.
     """
 
+    metric_parameter_overrides: Optional[Dict[str, object]]
+    """Override values for parameterized billable metric variables.
+
+    Keys are parameter names, values are the override values.
+    """
+
     minimum_amount: Optional[str]
     """[DEPRECATED] Use add_adjustments instead.
 
@@ -1776,6 +1782,12 @@ class ReplacePrice(TypedDict, total=False):
     The subscription's maximum amount for the replacement price.
     """
 
+    metric_parameter_overrides: Optional[Dict[str, object]]
+    """Override values for parameterized billable metric variables.
+
+    Keys are parameter names, values are the override values.
+    """
+
     minimum_amount: Optional[str]
     """[DEPRECATED] Use add_adjustments instead.