orb-billing 0.5.5 → 0.6.0

data/rbi/orb/models/trial_discount.rbi

@@ -6,14 +6,14 @@ module Orb
       OrHash =
         T.type_alias { T.any(Orb::TrialDiscount, Orb::Internal::AnyHash) }
 
+      sig { returns(Orb::TrialDiscount::DiscountType::OrSymbol) }
+      attr_accessor :discount_type
+
       # List of price_ids that this discount applies to. For plan/plan phase discounts,
       # this can be a subset of prices.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :applies_to_price_ids
 
-      sig { returns(Orb::TrialDiscount::DiscountType::OrSymbol) }
-      attr_accessor :discount_type
-
       sig { returns(T.nilable(String)) }
       attr_accessor :reason
 
@@ -27,18 +27,18 @@ module Orb
 
       sig do
         params(
-          applies_to_price_ids: T::Array[String],
           discount_type: Orb::TrialDiscount::DiscountType::OrSymbol,
+          applies_to_price_ids: T.nilable(T::Array[String]),
           reason: T.nilable(String),
           trial_amount_discount: T.nilable(String),
           trial_percentage_discount: T.nilable(Float)
         ).returns(T.attached_class)
       end
       def self.new(
+        discount_type:,
         # List of price_ids that this discount applies to. For plan/plan phase discounts,
         # this can be a subset of prices.
-        applies_to_price_ids:,
-        discount_type:,
+        applies_to_price_ids: nil,
         reason: nil,
         # Only available if discount_type is `trial`
         trial_amount_discount: nil,
@@ -50,8 +50,8 @@ module Orb
       sig do
         override.returns(
           {
-            applies_to_price_ids: T::Array[String],
             discount_type: Orb::TrialDiscount::DiscountType::OrSymbol,
+            applies_to_price_ids: T.nilable(T::Array[String]),
             reason: T.nilable(String),
             trial_amount_discount: T.nilable(String),
             trial_percentage_discount: T.nilable(Float)

data/rbi/orb/models/usage_discount.rbi

@@ -6,11 +6,6 @@ module Orb
       OrHash =
         T.type_alias { T.any(Orb::UsageDiscount, Orb::Internal::AnyHash) }
 
-      # List of price_ids that this discount applies to. For plan/plan phase discounts,
-      # this can be a subset of prices.
-      sig { returns(T::Array[String]) }
-      attr_accessor :applies_to_price_ids
-
       sig { returns(Orb::UsageDiscount::DiscountType::OrSymbol) }
       attr_accessor :discount_type
 
@@ -19,25 +14,30 @@ module Orb
       sig { returns(Float) }
       attr_accessor :usage_discount
 
+      # List of price_ids that this discount applies to. For plan/plan phase discounts,
+      # this can be a subset of prices.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :applies_to_price_ids
+
       sig { returns(T.nilable(String)) }
       attr_accessor :reason
 
       sig do
         params(
-          applies_to_price_ids: T::Array[String],
           discount_type: Orb::UsageDiscount::DiscountType::OrSymbol,
           usage_discount: Float,
+          applies_to_price_ids: T.nilable(T::Array[String]),
           reason: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
-        # List of price_ids that this discount applies to. For plan/plan phase discounts,
-        # this can be a subset of prices.
-        applies_to_price_ids:,
         discount_type:,
         # Only available if discount_type is `usage`. Number of usage units that this
         # discount is for
         usage_discount:,
+        # List of price_ids that this discount applies to. For plan/plan phase discounts,
+        # this can be a subset of prices.
+        applies_to_price_ids: nil,
         reason: nil
       )
       end
@@ -45,9 +45,9 @@ module Orb
       sig do
         override.returns(
           {
-            applies_to_price_ids: T::Array[String],
             discount_type: Orb::UsageDiscount::DiscountType::OrSymbol,
             usage_discount: Float,
+            applies_to_price_ids: T.nilable(T::Array[String]),
             reason: T.nilable(String)
           }
         )

data/rbi/orb/models.rbi

@@ -126,6 +126,8 @@ module Orb
 
   Item = Orb::Models::Item
 
+  ItemArchiveParams = Orb::Models::ItemArchiveParams
+
   ItemCreateParams = Orb::Models::ItemCreateParams
 
   ItemFetchParams = Orb::Models::ItemFetchParams
@@ -156,6 +158,8 @@ module Orb
 
   Plans = Orb::Models::Plans
 
+  PlanSetDefaultVersionParams = Orb::Models::PlanSetDefaultVersionParams
+
   PlanUpdateParams = Orb::Models::PlanUpdateParams
 
   Price = Orb::Models::Price

data/rbi/orb/resources/credit_notes.rbi

@@ -8,17 +8,17 @@ module Orb
       sig do
         params(
           line_items: T::Array[Orb::CreditNoteCreateParams::LineItem::OrHash],
+          reason: Orb::CreditNoteCreateParams::Reason::OrSymbol,
           memo: T.nilable(String),
-          reason: T.nilable(Orb::CreditNoteCreateParams::Reason::OrSymbol),
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::CreditNote)
       end
       def create(
         line_items:,
+        # An optional reason for the credit note.
+        reason:,
         # An optional memo to attach to the credit note.
         memo: nil,
-        # An optional reason for the credit note.
-        reason: nil,
         request_options: {}
       )
       end

data/rbi/orb/resources/customers/balance_transactions.rbi

@@ -47,13 +47,6 @@ module Orb
         # This endpoint retrieves all customer balance transactions in reverse
         # chronological order for a single customer, providing a complete audit trail of
         # all adjustments and invoice applications.
-        #
-        # ## Eligibility
-        #
-        # The customer balance can only be applied to invoices or adjusted manually if
-        # invoices are not synced to a separate invoicing provider. If a payment gateway
-        # such as Stripe is used, the balance will be applied to the invoice before
-        # forwarding payment to the gateway.
         sig do
           params(
             customer_id: String,

data/rbi/orb/resources/customers/credits/top_ups.rbi

@@ -45,7 +45,7 @@ module Orb
             # threshold, the top-up will be triggered.
             threshold:,
             # The date from which the top-up is active. If unspecified, the top-up is active
-            # immediately.
+            # immediately. This should not be more than 10 days in the past.
             active_from: nil,
             # The number of days or months after which the top-up expires. If unspecified, it
             # does not expire.
@@ -134,7 +134,7 @@ module Orb
             # threshold, the top-up will be triggered.
             threshold:,
             # The date from which the top-up is active. If unspecified, the top-up is active
-            # immediately.
+            # immediately. This should not be more than 10 days in the past.
             active_from: nil,
             # The number of days or months after which the top-up expires. If unspecified, it
             # does not expire.

data/rbi/orb/resources/customers.rbi

@@ -54,7 +54,8 @@ module Orb
             T.nilable(
               T.any(
                 Orb::CustomerCreateParams::TaxConfiguration::Avalara::OrHash,
-                Orb::CustomerCreateParams::TaxConfiguration::Taxjar::OrHash
+                Orb::CustomerCreateParams::TaxConfiguration::Taxjar::OrHash,
+                Orb::CustomerCreateParams::TaxConfiguration::Sphere::OrHash
               )
             ),
           tax_id: T.nilable(Orb::CustomerCreateParams::TaxID::OrHash),
@@ -252,7 +253,8 @@ module Orb
             T.nilable(
               T.any(
                 Orb::CustomerUpdateParams::TaxConfiguration::Avalara::OrHash,
-                Orb::CustomerUpdateParams::TaxConfiguration::Taxjar::OrHash
+                Orb::CustomerUpdateParams::TaxConfiguration::Taxjar::OrHash,
+                Orb::CustomerUpdateParams::TaxConfiguration::Sphere::OrHash
               )
             ),
           tax_id: T.nilable(Orb::CustomerUpdateParams::TaxID::OrHash),
@@ -453,10 +455,7 @@ module Orb
       # **Note**: This operation happens asynchronously and can be expected to take a
       # few minutes to propagate to related resources. However, querying for the
       # customer on subsequent GET requests while deletion is in process will reflect
-      # its deletion with a `deleted: true` property. Once the customer deletion has
-      # been fully processed, the customer will not be returned in the API.
-      #
-      # On successful processing, this returns an empty dictionary (`{}`) in the API.
+      # its deletion.
       sig do
         params(
           customer_id: String,
@@ -570,7 +569,8 @@ module Orb
             T.nilable(
               T.any(
                 Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Avalara::OrHash,
-                Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar::OrHash
+                Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar::OrHash,
+                Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Sphere::OrHash
               )
             ),
           tax_id:

data/rbi/orb/resources/dimensional_price_groups.rbi

@@ -17,7 +17,7 @@ module Orb
       # For example, suppose we have a billable metric that measures the number of
       # widgets used and we want to charge differently depending on the color of the
       # widget. We can create a price group with a dimension "color" and two prices: one
-      # that charges $10 per red widget and one that charges $20 per blue widget.
+      # that charges \$10 per red widget and one that charges \$20 per blue widget.
       sig do
         params(
           billable_metric_id: String,

data/rbi/orb/resources/items.rbi

@@ -7,12 +7,17 @@ module Orb
       sig do
         params(
           name: String,
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Item)
       end
       def create(
         # The name of the item.
         name:,
+        # User-specified key/value pairs for the resource. Individual keys can be removed
+        # by setting the value to `null`, and the entire metadata mapping can be cleared
+        # by setting `metadata` to `null`.
+        metadata: nil,
         request_options: {}
       )
       end
@@ -25,6 +30,7 @@ module Orb
             T.nilable(
               T::Array[Orb::ItemUpdateParams::ExternalConnection::OrHash]
             ),
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
           name: T.nilable(String),
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Item)
@@ -32,6 +38,10 @@ module Orb
       def update(
         item_id,
         external_connections: nil,
+        # User-specified key/value pairs for the resource. Individual keys can be removed
+        # by setting the value to `null`, and the entire metadata mapping can be cleared
+        # by setting `metadata` to `null`.
+        metadata: nil,
         name: nil,
         request_options: {}
       )
@@ -56,6 +66,16 @@ module Orb
       )
       end
 
+      # Archive item
+      sig do
+        params(
+          item_id: String,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::Item)
+      end
+      def archive(item_id, request_options: {})
+      end
+
       # This endpoint returns an item identified by its item_id.
       sig do
         params(

data/rbi/orb/resources/plans/external_plan_id/versions.rbi

@@ -0,0 +1,103 @@
+# typed: strong
+
+module Orb
+  module Resources
+    class Plans
+      class ExternalPlanID
+        class Versions
+          # This API endpoint is in beta and its interface may change. It is recommended for
+          # use only in test mode.
+          #
+          # This endpoint allows the creation of a new plan version for an existing plan.
+          sig do
+            params(
+              external_plan_id: String,
+              version: Integer,
+              add_adjustments:
+                T.nilable(
+                  T::Array[
+                    Orb::Plans::ExternalPlanID::VersionCreateParams::AddAdjustment::OrHash
+                  ]
+                ),
+              add_prices:
+                T.nilable(
+                  T::Array[
+                    Orb::Plans::ExternalPlanID::VersionCreateParams::AddPrice::OrHash
+                  ]
+                ),
+              remove_adjustments:
+                T.nilable(
+                  T::Array[
+                    Orb::Plans::ExternalPlanID::VersionCreateParams::RemoveAdjustment::OrHash
+                  ]
+                ),
+              remove_prices:
+                T.nilable(
+                  T::Array[
+                    Orb::Plans::ExternalPlanID::VersionCreateParams::RemovePrice::OrHash
+                  ]
+                ),
+              replace_adjustments:
+                T.nilable(
+                  T::Array[
+                    Orb::Plans::ExternalPlanID::VersionCreateParams::ReplaceAdjustment::OrHash
+                  ]
+                ),
+              replace_prices:
+                T.nilable(
+                  T::Array[
+                    Orb::Plans::ExternalPlanID::VersionCreateParams::ReplacePrice::OrHash
+                  ]
+                ),
+              set_as_default: T.nilable(T::Boolean),
+              request_options: Orb::RequestOptions::OrHash
+            ).returns(Orb::Models::Plans::ExternalPlanID::VersionCreateResponse)
+          end
+          def create(
+            external_plan_id,
+            # New version number.
+            version:,
+            # Additional adjustments to be added to the plan.
+            add_adjustments: nil,
+            # Additional prices to be added to the plan.
+            add_prices: nil,
+            # Adjustments to be removed from the plan.
+            remove_adjustments: nil,
+            # Prices to be removed from the plan.
+            remove_prices: nil,
+            # Adjustments to be replaced with additional adjustments on the plan.
+            replace_adjustments: nil,
+            # Prices to be replaced with additional prices on the plan.
+            replace_prices: nil,
+            # Set this new plan version as the default
+            set_as_default: nil,
+            request_options: {}
+          )
+          end
+
+          # This API endpoint is in beta and its interface may change. It is recommended for
+          # use only in test mode.
+          #
+          # This endpoint is used to fetch a plan version. It returns the phases, prices,
+          # and adjustments present on this version of the plan.
+          sig do
+            params(
+              version: String,
+              external_plan_id: String,
+              request_options: Orb::RequestOptions::OrHash
+            ).returns(
+              Orb::Models::Plans::ExternalPlanID::VersionRetrieveResponse
+            )
+          end
+          def retrieve(version, external_plan_id:, request_options: {})
+          end
+
+          # @api private
+          sig { params(client: Orb::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/orb/resources/plans/external_plan_id.rbi

@@ -4,10 +4,13 @@ module Orb
   module Resources
     class Plans
       class ExternalPlanID
+        sig { returns(Orb::Resources::Plans::ExternalPlanID::Versions) }
+        attr_reader :versions
+
         # This endpoint can be used to update the `external_plan_id`, and `metadata` of an
         # existing plan.
         #
-        # Other fields on a customer are currently immutable.
+        # Other fields on a plan are currently immutable.
         sig do
           params(
             other_external_plan_id: String,
@@ -55,6 +58,25 @@ module Orb
         def fetch(external_plan_id, request_options: {})
         end
 
+        # This API endpoint is in beta and its interface may change. It is recommended for
+        # use only in test mode.
+        #
+        # This endpoint allows setting the default version of a plan.
+        sig do
+          params(
+            external_plan_id: String,
+            version: Integer,
+            request_options: Orb::RequestOptions::OrHash
+          ).returns(Orb::Plan)
+        end
+        def set_default_version(
+          external_plan_id,
+          # Plan version to set as the default.
+          version:,
+          request_options: {}
+        )
+        end
+
         # @api private
         sig { params(client: Orb::Client).returns(T.attached_class) }
         def self.new(client:)

data/rbi/orb/resources/plans/versions.rbi

@@ -0,0 +1,91 @@
+# typed: strong
+
+module Orb
+  module Resources
+    class Plans
+      class Versions
+        # This API endpoint is in beta and its interface may change. It is recommended for
+        # use only in test mode.
+        #
+        # This endpoint allows the creation of a new plan version for an existing plan.
+        sig do
+          params(
+            plan_id: String,
+            version: Integer,
+            add_adjustments:
+              T.nilable(
+                T::Array[Orb::Plans::VersionCreateParams::AddAdjustment::OrHash]
+              ),
+            add_prices:
+              T.nilable(
+                T::Array[Orb::Plans::VersionCreateParams::AddPrice::OrHash]
+              ),
+            remove_adjustments:
+              T.nilable(
+                T::Array[
+                  Orb::Plans::VersionCreateParams::RemoveAdjustment::OrHash
+                ]
+              ),
+            remove_prices:
+              T.nilable(
+                T::Array[Orb::Plans::VersionCreateParams::RemovePrice::OrHash]
+              ),
+            replace_adjustments:
+              T.nilable(
+                T::Array[
+                  Orb::Plans::VersionCreateParams::ReplaceAdjustment::OrHash
+                ]
+              ),
+            replace_prices:
+              T.nilable(
+                T::Array[Orb::Plans::VersionCreateParams::ReplacePrice::OrHash]
+              ),
+            set_as_default: T.nilable(T::Boolean),
+            request_options: Orb::RequestOptions::OrHash
+          ).returns(Orb::Models::Plans::VersionCreateResponse)
+        end
+        def create(
+          plan_id,
+          # New version number.
+          version:,
+          # Additional adjustments to be added to the plan.
+          add_adjustments: nil,
+          # Additional prices to be added to the plan.
+          add_prices: nil,
+          # Adjustments to be removed from the plan.
+          remove_adjustments: nil,
+          # Prices to be removed from the plan.
+          remove_prices: nil,
+          # Adjustments to be replaced with additional adjustments on the plan.
+          replace_adjustments: nil,
+          # Prices to be replaced with additional prices on the plan.
+          replace_prices: nil,
+          # Set this new plan version as the default
+          set_as_default: nil,
+          request_options: {}
+        )
+        end
+
+        # This API endpoint is in beta and its interface may change. It is recommended for
+        # use only in test mode.
+        #
+        # This endpoint is used to fetch a plan version. It returns the phases, prices,
+        # and adjustments present on this version of the plan.
+        sig do
+          params(
+            version: String,
+            plan_id: String,
+            request_options: Orb::RequestOptions::OrHash
+          ).returns(Orb::Models::Plans::VersionRetrieveResponse)
+        end
+        def retrieve(version, plan_id:, request_options: {})
+        end
+
+        # @api private
+        sig { params(client: Orb::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/orb/resources/plans.rbi

@@ -6,6 +6,9 @@ module Orb
       sig { returns(Orb::Resources::Plans::ExternalPlanID) }
       attr_reader :external_plan_id
 
+      sig { returns(Orb::Resources::Plans::Versions) }
+      attr_reader :versions
+
       # This endpoint allows creation of plans including their prices.
       sig do
         params(
@@ -38,7 +41,10 @@ module Orb
                 Orb::PlanCreateParams::Price::MaxGroupTieredPackage::OrHash,
                 Orb::PlanCreateParams::Price::ScalableMatrixWithUnitPricing::OrHash,
                 Orb::PlanCreateParams::Price::ScalableMatrixWithTieredPricing::OrHash,
-                Orb::PlanCreateParams::Price::CumulativeGroupedBulk::OrHash
+                Orb::PlanCreateParams::Price::CumulativeGroupedBulk::OrHash,
+                Orb::PlanCreateParams::Price::TieredPackageWithMinimum::OrHash,
+                Orb::PlanCreateParams::Price::MatrixWithAllocation::OrHash,
+                Orb::PlanCreateParams::Price::GroupedTiered::OrHash
               )
             ],
           default_invoice_memo: T.nilable(String),
@@ -78,7 +84,7 @@ module Orb
       # This endpoint can be used to update the `external_plan_id`, and `metadata` of an
       # existing plan.
       #
-      # Other fields on a customer are currently immutable.
+      # Other fields on a plan are currently immutable.
       sig do
         params(
           plan_id: String,
@@ -160,6 +166,25 @@ module Orb
       def fetch(plan_id, request_options: {})
       end
 
+      # This API endpoint is in beta and its interface may change. It is recommended for
+      # use only in test mode.
+      #
+      # This endpoint allows setting the default version of a plan.
+      sig do
+        params(
+          plan_id: String,
+          version: Integer,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::Plan)
+      end
+      def set_default_version(
+        plan_id,
+        # Plan version to set as the default.
+        version:,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Orb::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/orb/resources/prices.rbi

@@ -7,7 +7,7 @@ module Orb
       attr_reader :external_price_id
 
       # This endpoint is used to create a [price](/product-catalog/price-configuration).
-      # A price created using this endpoint is always an add-on, meaning that it’s not
+      # A price created using this endpoint is always an add-on, meaning that it's not
       # associated with a specific plan and can instead be individually added to
       # subscriptions, including subscriptions on different plans.
       #
@@ -60,6 +60,10 @@ module Orb
               Orb::PriceCreateParams::BillingCycleConfiguration::OrHash
             ),
           conversion_rate: T.nilable(Float),
+          dimensional_price_configuration:
+            T.nilable(
+              Orb::PriceCreateParams::DimensionalPriceConfiguration::OrHash
+            ),
           external_price_id: T.nilable(String),
           fixed_price_quantity: T.nilable(Float),
           invoice_grouping_key: T.nilable(String),
@@ -120,6 +124,8 @@ module Orb
         billing_cycle_configuration: nil,
         # The per unit conversion rate of the price currency to the invoicing currency.
         conversion_rate: nil,
+        # For dimensional price: specifies a price group and dimension values
+        dimensional_price_configuration: nil,
         # An alias for the price.
         external_price_id: nil,
         # If the Price represents a fixed cost, this represents the quantity of units
@@ -177,14 +183,24 @@ module Orb
       )
       end
 
-      # This endpoint is used to evaluate the output of a price for a given customer and
-      # time range. It enables filtering and grouping the output using
+      # This endpoint is used to evaluate the output of price(s) for a given customer
+      # and time range over either ingested events or preview events. It enables
+      # filtering and grouping the output using
       # [computed properties](/extensibility/advanced-metrics#computed-properties),
       # supporting the following workflows:
       #
       # 1. Showing detailed usage and costs to the end customer.
       # 2. Auditing subtotals on invoice line items.
       #
+      # Prices may either reference existing prices in your Orb account or be defined
+      # inline in the request body. Up to 100 prices can be evaluated in a single
+      # request.
+      #
+      # Price evaluation by default uses ingested events, but you can also provide a
+      # list of preview events to use instead. Up to 500 preview events can be provided
+      # in a single request. When using ingested events, the start of the time range
+      # must be no more than 100 days ago.
+      #
       # For these workflows, the expressiveness of computed properties in both the
       # filters and grouping is critical. For example, if you'd like to show your
       # customer their usage grouped by hour and another property, you can do so with
@@ -194,40 +210,34 @@ module Orb
       # with the following `filter`:
       # `my_property = 'foo' AND my_other_property = 'bar'`.
       #
-      # By default, the start of the time range must be no more than 100 days ago and
-      # the length of the results must be no greater than 1000. Note that this is a POST
+      # The length of the results must be no greater than 1000. Note that this is a POST
       # endpoint rather than a GET endpoint because it employs a JSON body rather than
       # query parameters.
       sig do
         params(
-          price_id: String,
           timeframe_end: Time,
           timeframe_start: Time,
           customer_id: T.nilable(String),
+          events: T.nilable(T::Array[Orb::PriceEvaluateParams::Event::OrHash]),
           external_customer_id: T.nilable(String),
-          filter: T.nilable(String),
-          grouping_keys: T::Array[String],
+          price_evaluations:
+            T::Array[Orb::PriceEvaluateParams::PriceEvaluation::OrHash],
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Models::PriceEvaluateResponse)
       end
       def evaluate(
-        price_id,
         # The exclusive upper bound for event timestamps
         timeframe_end:,
         # The inclusive lower bound for event timestamps
         timeframe_start:,
         # The ID of the customer to which this evaluation is scoped.
         customer_id: nil,
+        # Optional list of preview events to use instead of actual usage data (max 500)
+        events: nil,
         # The external customer ID of the customer to which this evaluation is scoped.
         external_customer_id: nil,
-        # A boolean
-        # [computed property](/extensibility/advanced-metrics#computed-properties) used to
-        # filter the underlying billable metric
-        filter: nil,
-        # Properties (or
-        # [computed properties](/extensibility/advanced-metrics#computed-properties)) used
-        # to group the underlying billable metric
-        grouping_keys: nil,
+        # List of prices to evaluate (max 100)
+        price_evaluations: nil,
         request_options: {}
       )
       end