metronome-sdk 1.0.0 → 2.0.0

data/rbi/metronome_sdk/models/v1/alert_create_params.rbi

@@ -15,39 +15,41 @@ module MetronomeSDK
             )
           end
 
-        # Type of the alert
+        # Type of the threshold notification
         sig do
           returns(MetronomeSDK::V1::AlertCreateParams::AlertType::OrSymbol)
         end
         attr_accessor :alert_type
 
-        # Name of the alert
+        # Name of the threshold notification
         sig { returns(String) }
         attr_accessor :name
 
-        # Threshold value of the alert policy. Depending upon the alert type, this number
-        # may represent a financial amount, the days remaining, or a percentage reached.
+        # Threshold value of the notification policy. Depending upon the notification
+        # type, this number may represent a financial amount, the days remaining, or a
+        # percentage reached.
         sig { returns(Float) }
         attr_accessor :threshold
 
-        # For alerts of type `usage_threshold_reached`, specifies which billable metric to
-        # track the usage for.
+        # For threshold notifications of type `usage_threshold_reached`, specifies which
+        # billable metric to track the usage for.
         sig { returns(T.nilable(String)) }
         attr_reader :billable_metric_id
 
         sig { params(billable_metric_id: String).void }
         attr_writer :billable_metric_id
 
-        # An array of strings, representing a way to filter the credit grant this alert
-        # applies to, by looking at the credit_grant_type field on the credit grant. This
-        # field is only defined for CreditPercentage and CreditBalance alerts
+        # An array of strings, representing a way to filter the credit grant this
+        # threshold notification applies to, by looking at the credit_grant_type field on
+        # the credit grant. This field is only defined for CreditPercentage and
+        # CreditBalance notifications
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :credit_grant_type_filters
 
         sig { params(credit_grant_type_filters: T::Array[String]).void }
         attr_writer :credit_grant_type_filters
 
-        # ID of the credit's currency, defaults to USD. If the specific alert type
+        # ID of the credit's currency, defaults to USD. If the specific notification type
         # requires a pricing unit/currency, find the ID in the
         # [Metronome app](https://app.metronome.com/offering/pricing-units).
         sig { returns(T.nilable(String)) }
@@ -56,8 +58,8 @@ module MetronomeSDK
         sig { params(credit_type_id: String).void }
         attr_writer :credit_type_id
 
-        # A list of custom field filters for alert types that support advanced filtering.
-        # Only present for contract invoices.
+        # A list of custom field filters for threshold notification types that support
+        # advanced filtering. Only present for contract invoices.
         sig do
           returns(
             T.nilable(
@@ -77,25 +79,25 @@ module MetronomeSDK
         end
         attr_writer :custom_field_filters
 
-        # If provided, will create this alert for this specific customer. To create an
-        # alert for all customers, do not specify a `customer_id`.
+        # If provided, will create this threshold notification for this specific customer.
+        # To create a notification for all customers, do not specify a `customer_id`.
         sig { returns(T.nilable(String)) }
         attr_reader :customer_id
 
         sig { params(customer_id: String).void }
         attr_writer :customer_id
 
-        # If true, the alert will evaluate immediately on customers that already meet the
-        # alert threshold. If false, it will only evaluate on future customers that
-        # trigger the alert threshold. Defaults to true.
+        # If true, the threshold notification will evaluate immediately on customers that
+        # already meet the notification threshold. If false, it will only evaluate on
+        # future customers that trigger the threshold. Defaults to true.
         sig { returns(T.nilable(T::Boolean)) }
         attr_reader :evaluate_on_create
 
         sig { params(evaluate_on_create: T::Boolean).void }
         attr_writer :evaluate_on_create
 
-        # Only present for `spend_threshold_reached` alerts. Scope alert to a specific
-        # group key on individual line items.
+        # Only present for `spend_threshold_reached` notifications. Scope notification to
+        # a specific group key on individual line items.
         sig do
           returns(
             T.nilable(T::Array[MetronomeSDK::V1::AlertCreateParams::GroupValue])
@@ -111,16 +113,16 @@ module MetronomeSDK
         end
         attr_writer :group_values
 
-        # Only supported for invoice_total_reached alerts. A list of invoice types to
-        # evaluate.
+        # Only supported for invoice_total_reached threshold notifications. A list of
+        # invoice types to evaluate.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :invoice_types_filter
 
         sig { params(invoice_types_filter: T::Array[String]).void }
         attr_writer :invoice_types_filter
 
-        # If provided, will create this alert for this specific plan. To create an alert
-        # for all customers, do not specify a `plan_id`.
+        # If provided, will create this threshold notification for this specific plan. To
+        # create a notification for all customers, do not specify a `plan_id`.
         sig { returns(T.nilable(String)) }
         attr_reader :plan_id
 
@@ -160,42 +162,44 @@ module MetronomeSDK
           ).returns(T.attached_class)
         end
         def self.new(
-          # Type of the alert
+          # Type of the threshold notification
           alert_type:,
-          # Name of the alert
+          # Name of the threshold notification
           name:,
-          # Threshold value of the alert policy. Depending upon the alert type, this number
-          # may represent a financial amount, the days remaining, or a percentage reached.
+          # Threshold value of the notification policy. Depending upon the notification
+          # type, this number may represent a financial amount, the days remaining, or a
+          # percentage reached.
           threshold:,
-          # For alerts of type `usage_threshold_reached`, specifies which billable metric to
-          # track the usage for.
+          # For threshold notifications of type `usage_threshold_reached`, specifies which
+          # billable metric to track the usage for.
           billable_metric_id: nil,
-          # An array of strings, representing a way to filter the credit grant this alert
-          # applies to, by looking at the credit_grant_type field on the credit grant. This
-          # field is only defined for CreditPercentage and CreditBalance alerts
+          # An array of strings, representing a way to filter the credit grant this
+          # threshold notification applies to, by looking at the credit_grant_type field on
+          # the credit grant. This field is only defined for CreditPercentage and
+          # CreditBalance notifications
           credit_grant_type_filters: nil,
-          # ID of the credit's currency, defaults to USD. If the specific alert type
+          # ID of the credit's currency, defaults to USD. If the specific notification type
           # requires a pricing unit/currency, find the ID in the
           # [Metronome app](https://app.metronome.com/offering/pricing-units).
           credit_type_id: nil,
-          # A list of custom field filters for alert types that support advanced filtering.
-          # Only present for contract invoices.
+          # A list of custom field filters for threshold notification types that support
+          # advanced filtering. Only present for contract invoices.
           custom_field_filters: nil,
-          # If provided, will create this alert for this specific customer. To create an
-          # alert for all customers, do not specify a `customer_id`.
+          # If provided, will create this threshold notification for this specific customer.
+          # To create a notification for all customers, do not specify a `customer_id`.
           customer_id: nil,
-          # If true, the alert will evaluate immediately on customers that already meet the
-          # alert threshold. If false, it will only evaluate on future customers that
-          # trigger the alert threshold. Defaults to true.
+          # If true, the threshold notification will evaluate immediately on customers that
+          # already meet the notification threshold. If false, it will only evaluate on
+          # future customers that trigger the threshold. Defaults to true.
           evaluate_on_create: nil,
-          # Only present for `spend_threshold_reached` alerts. Scope alert to a specific
-          # group key on individual line items.
+          # Only present for `spend_threshold_reached` notifications. Scope notification to
+          # a specific group key on individual line items.
           group_values: nil,
-          # Only supported for invoice_total_reached alerts. A list of invoice types to
-          # evaluate.
+          # Only supported for invoice_total_reached threshold notifications. A list of
+          # invoice types to evaluate.
           invoice_types_filter: nil,
-          # If provided, will create this alert for this specific plan. To create an alert
-          # for all customers, do not specify a `plan_id`.
+          # If provided, will create this threshold notification for this specific plan. To
+          # create a notification for all customers, do not specify a `plan_id`.
           plan_id: nil,
           # Prevents the creation of duplicates. If a request to create a record is made
           # with a previously used uniqueness key, a new record will not be created and the
@@ -233,7 +237,7 @@ module MetronomeSDK
         def to_hash
         end
 
-        # Type of the alert
+        # Type of the threshold notification
         module AlertType
           extend MetronomeSDK::Internal::Type::Enum
 

data/rbi/metronome_sdk/models/v1/contract_amend_params.rbi

@@ -1469,6 +1469,11 @@ module MetronomeSDK
                   :ANROK,
                   MetronomeSDK::V1::ContractAmendParams::Commit::PaymentGateConfig::TaxType::TaggedSymbol
                 )
+              AVALARA =
+                T.let(
+                  :AVALARA,
+                  MetronomeSDK::V1::ContractAmendParams::Commit::PaymentGateConfig::TaxType::TaggedSymbol
+                )
               PRECALCULATED =
                 T.let(
                   :PRECALCULATED,

data/rbi/metronome_sdk/models/v1/contract_create_params.rbi

@@ -2011,6 +2011,11 @@ module MetronomeSDK
                   :ANROK,
                   MetronomeSDK::V1::ContractCreateParams::Commit::PaymentGateConfig::TaxType::TaggedSymbol
                 )
+              AVALARA =
+                T.let(
+                  :AVALARA,
+                  MetronomeSDK::V1::ContractCreateParams::Commit::PaymentGateConfig::TaxType::TaggedSymbol
+                )
               PRECALCULATED =
                 T.let(
                   :PRECALCULATED,
@@ -2888,7 +2893,9 @@ module MetronomeSDK
 
           sig do
             returns(
-              MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Parent
+              T.nilable(
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Parent
+              )
             )
           end
           attr_reader :parent
@@ -2901,20 +2908,98 @@ module MetronomeSDK
           end
           attr_writer :parent
 
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior
+              )
+            )
+          end
+          attr_reader :parent_behavior
+
+          sig do
+            params(
+              parent_behavior:
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior::OrHash
+            ).void
+          end
+          attr_writer :parent_behavior
+
+          # Indicates whether the parent should pay for the child's invoice charges
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Payer::OrSymbol
+              )
+            )
+          end
+          attr_reader :payer
+
+          sig do
+            params(
+              payer:
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Payer::OrSymbol
+            ).void
+          end
+          attr_writer :payer
+
+          # Indicates the behavior of the child's invoice statements on the parent's
+          # invoices **CONSOLIDATE**: Child's invoice statements will be added to parent's
+          # consolidated invoices **SEPARATE**: Child's invoice statements will appear not
+          # appear on parent's consolidated invoices
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::UsageStatementBehavior::OrSymbol
+              )
+            )
+          end
+          attr_reader :usage_statement_behavior
+
+          sig do
+            params(
+              usage_statement_behavior:
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::UsageStatementBehavior::OrSymbol
+            ).void
+          end
+          attr_writer :usage_statement_behavior
+
           sig do
             params(
               parent:
-                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Parent::OrHash
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Parent::OrHash,
+              parent_behavior:
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior::OrHash,
+              payer:
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Payer::OrSymbol,
+              usage_statement_behavior:
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::UsageStatementBehavior::OrSymbol
             ).returns(T.attached_class)
           end
-          def self.new(parent:)
+          def self.new(
+            parent: nil,
+            parent_behavior: nil,
+            # Indicates whether the parent should pay for the child's invoice charges
+            payer: nil,
+            # Indicates the behavior of the child's invoice statements on the parent's
+            # invoices **CONSOLIDATE**: Child's invoice statements will be added to parent's
+            # consolidated invoices **SEPARATE**: Child's invoice statements will appear not
+            # appear on parent's consolidated invoices
+            usage_statement_behavior: nil
+          )
           end
 
           sig do
             override.returns(
               {
                 parent:
-                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Parent
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Parent,
+                parent_behavior:
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior,
+                payer:
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Payer::OrSymbol,
+                usage_statement_behavior:
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::UsageStatementBehavior::OrSymbol
               }
             )
           end
@@ -2950,6 +3035,174 @@ module MetronomeSDK
             def to_hash
             end
           end
+
+          class ParentBehavior < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            # Indicates the desired behavior of consolidated invoices generated by the parent
+            # in a customer hierarchy **CONCATENATE**: Statements on the invoices of child
+            # customers will be appended to the consolidated invoice **NONE**: Do not generate
+            # consolidated invoices
+            sig do
+              returns(
+                T.nilable(
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior::InvoiceConsolidationType::OrSymbol
+                )
+              )
+            end
+            attr_reader :invoice_consolidation_type
+
+            sig do
+              params(
+                invoice_consolidation_type:
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior::InvoiceConsolidationType::OrSymbol
+              ).void
+            end
+            attr_writer :invoice_consolidation_type
+
+            sig do
+              params(
+                invoice_consolidation_type:
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior::InvoiceConsolidationType::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Indicates the desired behavior of consolidated invoices generated by the parent
+              # in a customer hierarchy **CONCATENATE**: Statements on the invoices of child
+              # customers will be appended to the consolidated invoice **NONE**: Do not generate
+              # consolidated invoices
+              invoice_consolidation_type: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  invoice_consolidation_type:
+                    MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior::InvoiceConsolidationType::OrSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # Indicates the desired behavior of consolidated invoices generated by the parent
+            # in a customer hierarchy **CONCATENATE**: Statements on the invoices of child
+            # customers will be appended to the consolidated invoice **NONE**: Do not generate
+            # consolidated invoices
+            module InvoiceConsolidationType
+              extend MetronomeSDK::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior::InvoiceConsolidationType
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              CONCATENATE =
+                T.let(
+                  :CONCATENATE,
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior::InvoiceConsolidationType::TaggedSymbol
+                )
+              NONE =
+                T.let(
+                  :NONE,
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior::InvoiceConsolidationType::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::ParentBehavior::InvoiceConsolidationType::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
+          # Indicates whether the parent should pay for the child's invoice charges
+          module Payer
+            extend MetronomeSDK::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Payer
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            SELF =
+              T.let(
+                :SELF,
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Payer::TaggedSymbol
+              )
+            PARENT =
+              T.let(
+                :PARENT,
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Payer::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::Payer::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          # Indicates the behavior of the child's invoice statements on the parent's
+          # invoices **CONSOLIDATE**: Child's invoice statements will be added to parent's
+          # consolidated invoices **SEPARATE**: Child's invoice statements will appear not
+          # appear on parent's consolidated invoices
+          module UsageStatementBehavior
+            extend MetronomeSDK::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::UsageStatementBehavior
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            CONSOLIDATE =
+              T.let(
+                :CONSOLIDATE,
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::UsageStatementBehavior::TaggedSymbol
+              )
+            SEPARATE =
+              T.let(
+                :SEPARATE,
+                MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::UsageStatementBehavior::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  MetronomeSDK::V1::ContractCreateParams::HierarchyConfiguration::UsageStatementBehavior::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
         end
 
         # Defaults to LOWEST_MULTIPLIER, which applies the greatest discount to list

data/rbi/metronome_sdk/models/v1/customer_detail.rbi

@@ -48,6 +48,10 @@ module MetronomeSDK
         sig { returns(String) }
         attr_accessor :name
 
+        # RFC 3339 timestamp indicating when the customer was last updated.
+        sig { returns(Time) }
+        attr_accessor :updated_at
+
         # RFC 3339 timestamp indicating when the customer was archived. Null if the
         # customer is active.
         sig { returns(T.nilable(Time)) }
@@ -79,6 +83,7 @@ module MetronomeSDK
             external_id: String,
             ingest_aliases: T::Array[String],
             name: String,
+            updated_at: Time,
             archived_at: T.nilable(Time),
             current_billable_status:
               MetronomeSDK::V1::CustomerDetail::CurrentBillableStatus::OrHash
@@ -99,6 +104,8 @@ module MetronomeSDK
           # in usage events
           ingest_aliases:,
           name:,
+          # RFC 3339 timestamp indicating when the customer was last updated.
+          updated_at:,
           # RFC 3339 timestamp indicating when the customer was archived. Null if the
           # customer is active.
           archived_at: nil,
@@ -117,6 +124,7 @@ module MetronomeSDK
               external_id: String,
               ingest_aliases: T::Array[String],
               name: String,
+              updated_at: Time,
               archived_at: T.nilable(Time),
               current_billable_status:
                 MetronomeSDK::V1::CustomerDetail::CurrentBillableStatus

data/rbi/metronome_sdk/models/v1/customer_preview_events_params.rbi

@@ -104,15 +104,6 @@ module MetronomeSDK
           sig { returns(String) }
           attr_accessor :event_type
 
-          # This has no effect for preview events, but may be set for consistency with Event
-          # objects. They will be processed even if they do not match the customer's ID or
-          # ingest aliases.
-          sig { returns(T.nilable(String)) }
-          attr_reader :customer_id
-
-          sig { params(customer_id: String).void }
-          attr_writer :customer_id
-
           sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
           attr_reader :properties
 
@@ -126,9 +117,9 @@ module MetronomeSDK
           sig { params(timestamp: String).void }
           attr_writer :timestamp
 
-          # This has no effect for preview events, but may be set for consistency with Event
-          # objects. Duplicate transaction_ids are NOT filtered out, even within the same
-          # request.
+          # Optional unique identifier for event deduplication. When provided, preview
+          # events are automatically deduplicated against historical events from the past 34
+          # days. Duplicate transaction IDs within the same request will return an error.
           sig { returns(T.nilable(String)) }
           attr_reader :transaction_id
 
@@ -138,7 +129,6 @@ module MetronomeSDK
           sig do
             params(
               event_type: String,
-              customer_id: String,
               properties: T::Hash[Symbol, T.anything],
               timestamp: String,
               transaction_id: String
@@ -146,16 +136,12 @@ module MetronomeSDK
           end
           def self.new(
             event_type:,
-            # This has no effect for preview events, but may be set for consistency with Event
-            # objects. They will be processed even if they do not match the customer's ID or
-            # ingest aliases.
-            customer_id: nil,
             properties: nil,
             # RFC 3339 formatted. If not provided, the current time will be used.
             timestamp: nil,
-            # This has no effect for preview events, but may be set for consistency with Event
-            # objects. Duplicate transaction_ids are NOT filtered out, even within the same
-            # request.
+            # Optional unique identifier for event deduplication. When provided, preview
+            # events are automatically deduplicated against historical events from the past 34
+            # days. Duplicate transaction IDs within the same request will return an error.
             transaction_id: nil
           )
           end
@@ -164,7 +150,6 @@ module MetronomeSDK
             override.returns(
               {
                 event_type: String,
-                customer_id: String,
                 properties: T::Hash[Symbol, T.anything],
                 timestamp: String,
                 transaction_id: String

data/rbi/metronome_sdk/models/v1/customer_preview_events_response.rbi

@@ -12,21 +12,22 @@ module MetronomeSDK
             )
           end
 
-        sig { returns(MetronomeSDK::V1::Customers::Invoice) }
-        attr_reader :data
-
-        sig { params(data: MetronomeSDK::V1::Customers::Invoice::OrHash).void }
-        attr_writer :data
+        sig { returns(T::Array[MetronomeSDK::V1::Customers::Invoice]) }
+        attr_accessor :data
 
         sig do
-          params(data: MetronomeSDK::V1::Customers::Invoice::OrHash).returns(
-            T.attached_class
-          )
+          params(
+            data: T::Array[MetronomeSDK::V1::Customers::Invoice::OrHash]
+          ).returns(T.attached_class)
         end
         def self.new(data:)
         end
 
-        sig { override.returns({ data: MetronomeSDK::V1::Customers::Invoice }) }
+        sig do
+          override.returns(
+            { data: T::Array[MetronomeSDK::V1::Customers::Invoice] }
+          )
+        end
         def to_hash
         end
       end

data/rbi/metronome_sdk/models/v1/customers/alert_list_params.rbi

@@ -27,8 +27,8 @@ module MetronomeSDK
           sig { params(next_page: String).void }
           attr_writer :next_page
 
-          # Optionally filter by alert status. If absent, only enabled alerts will be
-          # returned.
+          # Optionally filter by threshold notification status. If absent, only enabled
+          # notifications will be returned.
           sig do
             returns(
               T.nilable(
@@ -66,8 +66,8 @@ module MetronomeSDK
             customer_id:,
             # Cursor that indicates where the next page of results should start.
             next_page: nil,
-            # Optionally filter by alert status. If absent, only enabled alerts will be
-            # returned.
+            # Optionally filter by threshold notification status. If absent, only enabled
+            # notifications will be returned.
             alert_statuses: nil,
             request_options: {}
           )