orb-billing 1.26.0 → 1.28.0

data/rbi/orb/models/matrix_value.rbi

@@ -13,24 +13,35 @@ module Orb
       sig { returns(String) }
       attr_accessor :unit_amount
 
+      # Optional multiplier applied to rated quantity before unit_amount.
+      sig { returns(T.nilable(Float)) }
+      attr_accessor :scaling_factor
+
       # Configuration for a single matrix value
       sig do
         params(
           dimension_values: T::Array[T.nilable(String)],
-          unit_amount: String
+          unit_amount: String,
+          scaling_factor: T.nilable(Float)
         ).returns(T.attached_class)
       end
       def self.new(
         # One or two matrix keys to filter usage to this Matrix value by
         dimension_values:,
         # Unit price for the specified dimension_values
-        unit_amount:
+        unit_amount:,
+        # Optional multiplier applied to rated quantity before unit_amount.
+        scaling_factor: nil
       )
       end
 
       sig do
         override.returns(
-          { dimension_values: T::Array[T.nilable(String)], unit_amount: String }
+          {
+            dimension_values: T::Array[T.nilable(String)],
+            unit_amount: String,
+            scaling_factor: T.nilable(Float)
+          }
         )
       end
       def to_hash

data/rbi/orb/models/matrix_with_allocation_config.rbi

@@ -24,6 +24,11 @@ module Orb
       sig { returns(T::Array[Orb::MatrixWithAllocationConfig::MatrixValue]) }
       attr_accessor :matrix_values
 
+      # Optional multiplier applied to default-bucket quantity before
+      # default_unit_amount.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :scaling_factor
+
       # Configuration for matrix pricing with usage allocation
       sig do
         params(
@@ -31,7 +36,8 @@ module Orb
           default_unit_amount: String,
           dimensions: T::Array[T.nilable(String)],
           matrix_values:
-            T::Array[Orb::MatrixWithAllocationConfig::MatrixValue::OrHash]
+            T::Array[Orb::MatrixWithAllocationConfig::MatrixValue::OrHash],
+          scaling_factor: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -42,7 +48,10 @@ module Orb
         # One or two event property values to evaluate matrix groups by
         dimensions:,
         # Matrix values configuration
-        matrix_values:
+        matrix_values:,
+        # Optional multiplier applied to default-bucket quantity before
+        # default_unit_amount.
+        scaling_factor: nil
       )
       end
 
@@ -53,7 +62,8 @@ module Orb
             default_unit_amount: String,
             dimensions: T::Array[T.nilable(String)],
             matrix_values:
-              T::Array[Orb::MatrixWithAllocationConfig::MatrixValue]
+              T::Array[Orb::MatrixWithAllocationConfig::MatrixValue],
+            scaling_factor: T.nilable(String)
           }
         )
       end
@@ -79,11 +89,16 @@ module Orb
         sig { returns(String) }
         attr_accessor :unit_amount
 
+        # Optional multiplier applied to rated quantity before unit_amount.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :scaling_factor
+
         # Configuration for a single matrix value
         sig do
           params(
             dimension_values: T::Array[T.nilable(String)],
-            unit_amount: String
+            unit_amount: String,
+            scaling_factor: T.nilable(String)
           ).returns(T.attached_class)
         end
         def self.new(
@@ -92,7 +107,9 @@ module Orb
           # instance tier.
           dimension_values:,
           # Unit price for the specified dimension_values
-          unit_amount:
+          unit_amount:,
+          # Optional multiplier applied to rated quantity before unit_amount.
+          scaling_factor: nil
         )
         end
 
@@ -100,7 +117,8 @@ module Orb
           override.returns(
             {
               dimension_values: T::Array[T.nilable(String)],
-              unit_amount: String
+              unit_amount: String,
+              scaling_factor: T.nilable(String)
             }
           )
         end

data/rbi/orb/models/new_floating_bulk_price.rbi

@@ -113,7 +113,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -192,7 +196,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_bulk_with_proration_price.rbi

@@ -122,7 +122,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -203,7 +207,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_cumulative_grouped_bulk_price.rbi

@@ -129,7 +129,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -211,7 +215,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_grouped_allocation_price.rbi

@@ -122,7 +122,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -203,7 +207,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_grouped_tiered_package_price.rbi

@@ -129,7 +129,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -210,7 +214,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_grouped_tiered_price.rbi

@@ -118,7 +118,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -198,7 +202,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_grouped_with_metered_minimum_price.rbi

@@ -133,7 +133,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -215,7 +219,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_grouped_with_prorated_minimum_price.rbi

@@ -133,7 +133,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -215,7 +219,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_matrix_price.rbi

@@ -113,7 +113,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -192,7 +196,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_matrix_with_allocation_price.rbi

@@ -124,7 +124,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -205,7 +209,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_matrix_with_display_name_price.rbi

@@ -129,7 +129,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -211,7 +215,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_max_group_tiered_package_price.rbi

@@ -129,7 +129,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -211,7 +215,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_minimum_composite_price.rbi

@@ -122,7 +122,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -203,7 +207,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_package_price.rbi

@@ -113,7 +113,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -192,7 +196,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_package_with_allocation_price.rbi

@@ -129,7 +129,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -211,7 +215,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_scalable_matrix_with_tiered_pricing_price.rbi

@@ -133,7 +133,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -215,7 +219,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_scalable_matrix_with_unit_pricing_price.rbi

@@ -133,7 +133,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -215,7 +219,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_threshold_total_amount_price.rbi

@@ -129,7 +129,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -210,7 +214,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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

data/rbi/orb/models/new_floating_tiered_package_price.rbi

@@ -118,7 +118,11 @@ module Orb
       end
       attr_writer :invoicing_cycle_configuration
 
-      # The ID of the license type to associate with this price.
+      # The ID of the license type to associate with this price. On a usage price this
+      # also marks the price as eligible to draw down from that license type's
+      # allocation; a usage price created without it is billed normally. Usage prices
+      # with a license type must use the `unit` model, and only draw down when their
+      # currency matches the allocation's.
       sig { returns(T.nilable(String)) }
       attr_accessor :license_type_id
 
@@ -198,7 +202,11 @@ module Orb
         # Within each billing cycle, specifies the cadence at which invoices are produced.
         # If unspecified, a single invoice is produced per billing cycle.
         invoicing_cycle_configuration: nil,
-        # The ID of the license type to associate with this price.
+        # The ID of the license type to associate with this price. On a usage price this
+        # also marks the price as eligible to draw down from that license type's
+        # allocation; a usage price created without it is billed normally. Usage prices
+        # with a license type must use the `unit` model, and only draw down when their
+        # currency matches the allocation's.
         license_type_id: 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