orb-billing 1.26.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c12cf6290d59fdfbe36363756a6faa1e1b1edaafc01c4f4fbc6ab3dc898de7a
-  data.tar.gz: ffeb5a57b526735247d9256f825b1998b3fb5cc4f4e5017995ea0d4175917df5
+  metadata.gz: 9963c97978a5d148cea925094ef65f1f198cb85230d9ea6fdfc0988d6c92df2e
+  data.tar.gz: 39ada2b3ae8568cbf46ed3d80a8c6a4bf9539546cd510f9cc7cca83912fd964f
 SHA512:
-  metadata.gz: 9b63ed1f28b0e9935bf91cde9c2e4685f984aec88f424d61673cc6609f7b3716a1c7b597818aabd4f7b28b4329ce1658604d01c88e7c41fb2dd17f0504ef4b1b
-  data.tar.gz: e87a204410f241783b196af74f0af0642d27bcc84aa68e99213b810622bc1a17a4b2ba4797373805a40026a2b3c3c8f1a02509cb4777b02200fb51a1e7beae9b
+  metadata.gz: 376cf1aa3abd49b701bfba2b33bdbd4976c5916e798014a83b08ea2e6f0b709bf981046616fbef1f475559f9dd6f0e2738f147d1c221da7ced3695c9b98bc8eb
+  data.tar.gz: aee8e43ed717d30c552b3b7a021113c9079615282fcdbff4c43fc1be3a60ff9a8f079287240b07151346b0630c324856c650eda5c4f1ab4773405a6251319a6f

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.27.0](https://github.com/orbcorp/orb-ruby/compare/v1.26.0...v1.27.0) (2026-08-19)
+
+
+### Features
+
+* **api:** api update ([da11b3c](https://github.com/orbcorp/orb-ruby/commit/da11b3c2eb302a4f3ddef2da41f57d53eb5d5100))
+
 ## [1.26.0](https://github.com/orbcorp/orb-ruby/compare/v1.25.0...v1.26.0) (2026-08-07)
 
 

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "orb-billing", "~> 1.26.0"
+gem "orb-billing", "~> 1.27.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/orb/models/beta/external_plan_id_create_plan_version_params.rb

@@ -417,7 +417,8 @@ module Orb
             # @!attribute license_allocations
             #   License allocations to associate with this price. Each entry defines a
             #   per-license credit pool granted each cadence. Requires license_type_id or
-            #   license_type_configuration to be set.
+            #   license_type_configuration to be set. Usage prices draw down from these
+            #   allocations only if they set the same license type.
             #
             #   @return [Array<Orb::Models::Beta::ExternalPlanIDCreatePlanVersionParams::AddPrice::LicenseAllocationPrice::LicenseAllocation>]
             required :license_allocations,
@@ -519,7 +520,11 @@ module Orb
             optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
             # @!attribute license_type_id
-            #   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.
             #
             #   @return [String, nil]
             optional :license_type_id, String, nil?: true
@@ -580,7 +585,7 @@ module Orb
             #
             #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
             #
-            #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+            #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
             #
             #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
             #
@@ -840,7 +845,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -895,7 +904,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -1105,7 +1114,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -1160,7 +1173,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -1364,7 +1377,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -1419,7 +1436,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -1680,7 +1697,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -1735,7 +1756,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -1916,7 +1937,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -1971,7 +1996,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -2145,7 +2170,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -2200,7 +2229,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -2374,7 +2403,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -2429,7 +2462,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -2650,7 +2683,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -2705,7 +2742,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -2904,7 +2941,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -2959,7 +3000,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -3139,7 +3180,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -3194,7 +3239,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -3629,7 +3674,8 @@ module Orb
             # @!attribute license_allocations
             #   License allocations to associate with this price. Each entry defines a
             #   per-license credit pool granted each cadence. Requires license_type_id or
-            #   license_type_configuration to be set.
+            #   license_type_configuration to be set. Usage prices draw down from these
+            #   allocations only if they set the same license type.
             #
             #   @return [Array<Orb::Models::Beta::ExternalPlanIDCreatePlanVersionParams::ReplacePrice::LicenseAllocationPrice::LicenseAllocation>]
             required :license_allocations,
@@ -3731,7 +3777,11 @@ module Orb
             optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
             # @!attribute license_type_id
-            #   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.
             #
             #   @return [String, nil]
             optional :license_type_id, String, nil?: true
@@ -3792,7 +3842,7 @@ module Orb
             #
             #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
             #
-            #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+            #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
             #
             #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
             #
@@ -4052,7 +4102,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -4107,7 +4161,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -4317,7 +4371,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -4372,7 +4430,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -4576,7 +4634,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -4631,7 +4693,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -4892,7 +4954,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -4947,7 +5013,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -5128,7 +5194,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -5183,7 +5253,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -5357,7 +5427,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -5412,7 +5486,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -5586,7 +5660,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -5641,7 +5719,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -5862,7 +5940,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -5917,7 +5999,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -6116,7 +6198,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -6171,7 +6257,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #
@@ -6351,7 +6437,11 @@ module Orb
               optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
 
               # @!attribute license_type_id
-              #   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.
               #
               #   @return [String, nil]
               optional :license_type_id, String, nil?: true
@@ -6406,7 +6496,7 @@ module Orb
               #
               #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
               #
-              #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+              #   @param license_type_id [String, nil] The ID of the license type to associate with this price. On a usage price this a
               #
               #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
               #