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

lib/orb/models/alert.rb

@@ -74,13 +74,20 @@ class Alert < Orb::Internal::Type::BaseModel
                -> { Orb::Internal::Type::ArrayOf[Orb::Alert::BalanceAlertStatus] },
                nil?: true
 
+      # @!attribute grouping_keys
+      #   The property keys to group cost alerts by. Only present for cost alerts with
+      #   grouping enabled.
+      #
+      #   @return [Array<String>, nil]
+      optional :grouping_keys, Orb::Internal::Type::ArrayOf[String], nil?: true
+
       # @!attribute license_type
       #   Minified license type for alert serialization.
       #
       #   @return [Orb::Models::Alert::LicenseType, nil]
       optional :license_type, -> { Orb::Alert::LicenseType }, nil?: true
 
-      # @!method initialize(id:, created_at:, currency:, customer:, enabled:, metric:, plan:, subscription:, thresholds:, type:, balance_alert_status: nil, license_type: nil)
+      # @!method initialize(id:, created_at:, currency:, customer:, enabled:, metric:, plan:, subscription:, thresholds:, type:, balance_alert_status: nil, grouping_keys: nil, license_type: nil)
       #   Some parameter documentations has been truncated, see {Orb::Models::Alert} for
       #   more details.
       #
@@ -112,6 +119,8 @@ class Alert < Orb::Internal::Type::BaseModel
       #
       #   @param balance_alert_status [Array<Orb::Models::Alert::BalanceAlertStatus>, nil] The current status of the alert. This field is only present for credit balance a
       #
+      #   @param grouping_keys [Array<String>, nil] The property keys to group cost alerts by. Only present for cost alerts with gro
+      #
       #   @param license_type [Orb::Models::Alert::LicenseType, nil] Minified license type for alert serialization.
 
       # @see Orb::Models::Alert#metric

lib/orb/models/alert_create_for_subscription_params.rb

@@ -24,21 +24,42 @@ class AlertCreateForSubscriptionParams < Orb::Internal::Type::BaseModel
       #   @return [Symbol, Orb::Models::AlertCreateForSubscriptionParams::Type]
       required :type, enum: -> { Orb::AlertCreateForSubscriptionParams::Type }
 
+      # @!attribute grouping_keys
+      #   The property keys to group cost alerts by. Only applicable for cost_exceeded
+      #   alerts.
+      #
+      #   @return [Array<String>, nil]
+      optional :grouping_keys, Orb::Internal::Type::ArrayOf[String], nil?: true
+
       # @!attribute metric_id
       #   The metric to track usage for.
       #
       #   @return [String, nil]
       optional :metric_id, String, nil?: true
 
-      # @!method initialize(subscription_id:, thresholds:, type:, metric_id: nil, request_options: {})
+      # @!attribute pricing_unit_id
+      #   The pricing unit to use for grouped cost alerts. Required when grouping_keys is
+      #   set.
+      #
+      #   @return [String, nil]
+      optional :pricing_unit_id, String, nil?: true
+
+      # @!method initialize(subscription_id:, thresholds:, type:, grouping_keys: nil, metric_id: nil, pricing_unit_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Orb::Models::AlertCreateForSubscriptionParams} for more details.
+      #
       #   @param subscription_id [String]
       #
       #   @param thresholds [Array<Orb::Models::Threshold>] The thresholds that define the values at which the alert will be triggered.
       #
       #   @param type [Symbol, Orb::Models::AlertCreateForSubscriptionParams::Type] The type of alert to create. This must be a valid alert type.
       #
+      #   @param grouping_keys [Array<String>, nil] The property keys to group cost alerts by. Only applicable for cost_exceeded ale
+      #
       #   @param metric_id [String, nil] The metric to track usage for.
       #
+      #   @param pricing_unit_id [String, nil] The pricing unit to use for grouped cost alerts. Required when grouping_keys is
+      #
       #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
 
       # The type of alert to create. This must be a valid alert type.

lib/orb/resources/alerts.rb

@@ -179,6 +179,9 @@ def create_for_external_customer(external_customer_id, params)
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Orb::Models::AlertCreateForSubscriptionParams} for more details.
+      #
       # This endpoint is used to create alerts at the subscription level.
       #
       # Subscription level alerts can be one of two types: `usage_exceeded` or
@@ -191,16 +194,20 @@ def create_for_external_customer(external_customer_id, params)
       # per metric that is a part of the subscription. Alerts are triggered based on
       # usage or cost conditions met during the current billing cycle.
       #
-      # @overload create_for_subscription(subscription_id, thresholds:, type:, metric_id: nil, request_options: {})
+      # @overload create_for_subscription(subscription_id, thresholds:, type:, grouping_keys: nil, metric_id: nil, pricing_unit_id: nil, request_options: {})
       #
       # @param subscription_id [String]
       #
       # @param thresholds [Array<Orb::Models::Threshold>] The thresholds that define the values at which the alert will be triggered.
       #
       # @param type [Symbol, Orb::Models::AlertCreateForSubscriptionParams::Type] The type of alert to create. This must be a valid alert type.
       #
+      # @param grouping_keys [Array<String>, nil] The property keys to group cost alerts by. Only applicable for cost_exceeded ale
+      #
       # @param metric_id [String, nil] The metric to track usage for.
       #
+      # @param pricing_unit_id [String, nil] The pricing unit to use for grouped cost alerts. Required when grouping_keys is
+      #
       # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Orb::Models::Alert]

rbi/orb/models/alert.rbi

@@ -65,6 +65,11 @@ module Orb
       sig { returns(T.nilable(T::Array[Orb::Alert::BalanceAlertStatus])) }
       attr_accessor :balance_alert_status
 
+      # The property keys to group cost alerts by. Only present for cost alerts with
+      # grouping enabled.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :grouping_keys
+
       # Minified license type for alert serialization.
       sig { returns(T.nilable(Orb::Alert::LicenseType)) }
       attr_reader :license_type
@@ -93,6 +98,7 @@ module Orb
           type: Orb::Alert::Type::OrSymbol,
           balance_alert_status:
             T.nilable(T::Array[Orb::Alert::BalanceAlertStatus::OrHash]),
+          grouping_keys: T.nilable(T::Array[String]),
           license_type: T.nilable(Orb::Alert::LicenseType::OrHash)
         ).returns(T.attached_class)
       end
@@ -121,6 +127,9 @@ module Orb
         # The current status of the alert. This field is only present for credit balance
         # alerts.
         balance_alert_status: nil,
+        # The property keys to group cost alerts by. Only present for cost alerts with
+        # grouping enabled.
+        grouping_keys: nil,
         # Minified license type for alert serialization.
         license_type: nil
       )
@@ -141,6 +150,7 @@ module Orb
             type: Orb::Alert::Type::TaggedSymbol,
             balance_alert_status:
               T.nilable(T::Array[Orb::Alert::BalanceAlertStatus]),
+            grouping_keys: T.nilable(T::Array[String]),
             license_type: T.nilable(Orb::Alert::LicenseType)
           }
         )

rbi/orb/models/alert_create_for_subscription_params.rbi

@@ -22,16 +22,28 @@ module Orb
       sig { returns(Orb::AlertCreateForSubscriptionParams::Type::OrSymbol) }
       attr_accessor :type
 
+      # The property keys to group cost alerts by. Only applicable for cost_exceeded
+      # alerts.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :grouping_keys
+
       # The metric to track usage for.
       sig { returns(T.nilable(String)) }
       attr_accessor :metric_id
 
+      # The pricing unit to use for grouped cost alerts. Required when grouping_keys is
+      # set.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :pricing_unit_id
+
       sig do
         params(
           subscription_id: String,
           thresholds: T::Array[Orb::Threshold::OrHash],
           type: Orb::AlertCreateForSubscriptionParams::Type::OrSymbol,
+          grouping_keys: T.nilable(T::Array[String]),
           metric_id: T.nilable(String),
+          pricing_unit_id: T.nilable(String),
           request_options: Orb::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -41,8 +53,14 @@ module Orb
         thresholds:,
         # The type of alert to create. This must be a valid alert type.
         type:,
+        # The property keys to group cost alerts by. Only applicable for cost_exceeded
+        # alerts.
+        grouping_keys: nil,
         # The metric to track usage for.
         metric_id: nil,
+        # The pricing unit to use for grouped cost alerts. Required when grouping_keys is
+        # set.
+        pricing_unit_id: nil,
         request_options: {}
       )
       end
@@ -53,7 +71,9 @@ module Orb
             subscription_id: String,
             thresholds: T::Array[Orb::Threshold],
             type: Orb::AlertCreateForSubscriptionParams::Type::OrSymbol,
+            grouping_keys: T.nilable(T::Array[String]),
             metric_id: T.nilable(String),
+            pricing_unit_id: T.nilable(String),
             request_options: Orb::RequestOptions
           }
         )

rbi/orb/resources/alerts.rbi

@@ -153,7 +153,9 @@ module Orb
           subscription_id: String,
           thresholds: T::Array[Orb::Threshold::OrHash],
           type: Orb::AlertCreateForSubscriptionParams::Type::OrSymbol,
+          grouping_keys: T.nilable(T::Array[String]),
           metric_id: T.nilable(String),
+          pricing_unit_id: T.nilable(String),
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Alert)
       end
@@ -163,8 +165,14 @@ module Orb
         thresholds:,
         # The type of alert to create. This must be a valid alert type.
         type:,
+        # The property keys to group cost alerts by. Only applicable for cost_exceeded
+        # alerts.
+        grouping_keys: nil,
         # The metric to track usage for.
         metric_id: nil,
+        # The pricing unit to use for grouped cost alerts. Required when grouping_keys is
+        # set.
+        pricing_unit_id: nil,
         request_options: {}
       )
       end

sig/orb/models/alert.rbs

@@ -13,6 +13,7 @@ module Orb
         thresholds: ::Array[Orb::Threshold]?,
         type: Orb::Models::Alert::type_,
         balance_alert_status: ::Array[Orb::Alert::BalanceAlertStatus]?,
+        grouping_keys: ::Array[String]?,
         license_type: Orb::Alert::LicenseType?
       }
 
@@ -39,6 +40,8 @@ module Orb
 
       attr_accessor balance_alert_status: ::Array[Orb::Alert::BalanceAlertStatus]?
 
+      attr_accessor grouping_keys: ::Array[String]?
+
       attr_accessor license_type: Orb::Alert::LicenseType?
 
       def initialize: (
@@ -53,6 +56,7 @@ module Orb
         thresholds: ::Array[Orb::Threshold]?,
         type: Orb::Models::Alert::type_,
         ?balance_alert_status: ::Array[Orb::Alert::BalanceAlertStatus]?,
+        ?grouping_keys: ::Array[String]?,
         ?license_type: Orb::Alert::LicenseType?
       ) -> void
 
@@ -68,6 +72,7 @@ module Orb
         thresholds: ::Array[Orb::Threshold]?,
         type: Orb::Models::Alert::type_,
         balance_alert_status: ::Array[Orb::Alert::BalanceAlertStatus]?,
+        grouping_keys: ::Array[String]?,
         license_type: Orb::Alert::LicenseType?
       }
 

sig/orb/models/alert_create_for_subscription_params.rbs

@@ -5,7 +5,9 @@ module Orb
         subscription_id: String,
         thresholds: ::Array[Orb::Threshold],
         type: Orb::Models::AlertCreateForSubscriptionParams::type_,
-        metric_id: String?
+        grouping_keys: ::Array[String]?,
+        metric_id: String?,
+        pricing_unit_id: String?
       }
       & Orb::Internal::Type::request_parameters
 
@@ -19,21 +21,29 @@ module Orb
 
       attr_accessor type: Orb::Models::AlertCreateForSubscriptionParams::type_
 
+      attr_accessor grouping_keys: ::Array[String]?
+
       attr_accessor metric_id: String?
 
+      attr_accessor pricing_unit_id: String?
+
       def initialize: (
         subscription_id: String,
         thresholds: ::Array[Orb::Threshold],
         type: Orb::Models::AlertCreateForSubscriptionParams::type_,
+        ?grouping_keys: ::Array[String]?,
         ?metric_id: String?,
+        ?pricing_unit_id: String?,
         ?request_options: Orb::request_opts
       ) -> void
 
       def to_hash: -> {
         subscription_id: String,
         thresholds: ::Array[Orb::Threshold],
         type: Orb::Models::AlertCreateForSubscriptionParams::type_,
+        grouping_keys: ::Array[String]?,
         metric_id: String?,
+        pricing_unit_id: String?,
         request_options: Orb::RequestOptions
       }
 

sig/orb/resources/alerts.rbs

@@ -45,7 +45,9 @@ module Orb
         String subscription_id,
         thresholds: ::Array[Orb::Threshold],
         type: Orb::Models::AlertCreateForSubscriptionParams::type_,
+        ?grouping_keys: ::Array[String]?,
         ?metric_id: String?,
+        ?pricing_unit_id: String?,
         ?request_options: Orb::request_opts
       ) -> Orb::Alert