orb-billing 0.1.3 → 0.3.0

data/rbi/lib/orb/models/plan_create_params.rbi

@@ -122,13 +122,26 @@ module Orb
           .returns(T.attached_class)
       end
       def self.new(
+        # An ISO 4217 currency string for invoices generated by subscriptions on this
+        # plan.
         currency:,
         name:,
+        # Prices for this plan. If the plan has phases, this includes prices across all
+        # phases of the plan.
         prices:,
+        # Free-form text which is available on the invoice PDF and the Orb invoice portal.
         default_invoice_memo: nil,
         external_plan_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
+        # by setting `metadata` to `null`.
         metadata: nil,
+        # The net terms determines the difference between the invoice date and the issue
+        # date for the invoice. If you intend the invoice to be due on issue, set this
+        # to 0.
         net_terms: nil,
+        # The status of the plan to create (either active or draft). If not specified,
+        # this defaults to active.
         status: nil,
         request_options: {}
       ); end
@@ -313,19 +326,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             unit_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :unit
           ); end
@@ -359,8 +393,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanUnitPrice::Cadence) }
-            OrSymbol =
-              T.type_alias { T.any(Symbol, String, Orb::Models::PlanCreateParams::Price::NewPlanUnitPrice::Cadence::TaggedSymbol) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL = T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanUnitPrice::Cadence::TaggedSymbol)
             SEMI_ANNUAL =
@@ -382,8 +415,10 @@ module Orb
             attr_accessor :unit_amount
 
             sig { params(unit_amount: String).returns(T.attached_class) }
-            def self.new(unit_amount:); end
-
+            def self.new(
+              # Rate per unit of usage
+              unit_amount:
+            ); end
             sig { override.returns({unit_amount: String}) }
             def to_hash; end
           end
@@ -410,8 +445,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -431,14 +470,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanUnitPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanUnitPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -485,8 +517,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -506,14 +542,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanUnitPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanUnitPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -671,19 +700,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             package_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :package
           ); end
@@ -717,8 +767,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanPackagePrice::Cadence) }
-            OrSymbol =
-              T.type_alias { T.any(Symbol, String, Orb::Models::PlanCreateParams::Price::NewPlanPackagePrice::Cadence::TaggedSymbol) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL = T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanPackagePrice::Cadence::TaggedSymbol)
             SEMI_ANNUAL =
@@ -749,8 +798,13 @@ module Orb
             attr_accessor :package_size
 
             sig { params(package_amount: String, package_size: Integer).returns(T.attached_class) }
-            def self.new(package_amount:, package_size:); end
-
+            def self.new(
+              # A currency amount to rate usage by
+              package_amount:,
+              # An integer amount to represent package size. For example, 1000 here would divide
+              # usage by 1000 before multiplying by package_amount in rating
+              package_size:
+            ); end
             sig { override.returns({package_amount: String, package_size: Integer}) }
             def to_hash; end
           end
@@ -777,8 +831,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -798,14 +856,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanPackagePrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanPackagePrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -852,8 +903,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -873,14 +928,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanPackagePrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanPackagePrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -1038,19 +1086,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
             matrix_config:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :matrix
           ); end
@@ -1084,8 +1153,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanMatrixPrice::Cadence) }
-            OrSymbol =
-              T.type_alias { T.any(Symbol, String, Orb::Models::PlanCreateParams::Price::NewPlanMatrixPrice::Cadence::TaggedSymbol) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL = T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanMatrixPrice::Cadence::TaggedSymbol)
             SEMI_ANNUAL =
@@ -1130,8 +1198,14 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(default_unit_amount:, dimensions:, matrix_values:); end
-
+            def self.new(
+              # Default per unit rate for any usage not bucketed into a specified matrix_value
+              default_unit_amount:,
+              # One or two event property values to evaluate matrix groups by
+              dimensions:,
+              # Matrix values for specified matrix grouping keys
+              matrix_values:
+            ); end
             sig do
               override
                 .returns(
@@ -1161,8 +1235,14 @@ module Orb
                   unit_amount: String
                 ).returns(T.attached_class)
               end
-              def self.new(dimension_values:, unit_amount:); end
-
+              def self.new(
+                # One or two matrix keys to filter usage to this Matrix value by. For example,
+                # ["region", "tier"] could be used to filter cloud usage by a cloud region and an
+                # instance tier.
+                dimension_values:,
+                # Unit price for the specified dimension_values
+                unit_amount:
+              ); end
               sig { override.returns({dimension_values: T::Array[T.nilable(String)], unit_amount: String}) }
               def to_hash; end
             end
@@ -1190,8 +1270,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -1211,14 +1295,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanMatrixPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanMatrixPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -1265,8 +1342,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -1286,14 +1367,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanMatrixPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanMatrixPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -1451,19 +1525,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             tiered_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :tiered
           ); end
@@ -1497,8 +1592,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredPrice::Cadence) }
-            OrSymbol =
-              T.type_alias { T.any(Symbol, String, Orb::Models::PlanCreateParams::Price::NewPlanTieredPrice::Cadence::TaggedSymbol) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL = T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanTieredPrice::Cadence::TaggedSymbol)
             SEMI_ANNUAL =
@@ -1533,8 +1627,10 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(tiers:); end
-
+            def self.new(
+              # Tiers for rating based on total usage quantities into the specified tier
+              tiers:
+            ); end
             sig do
               override
                 .returns({tiers: T::Array[Orb::Models::PlanCreateParams::Price::NewPlanTieredPrice::TieredConfig::Tier]})
@@ -1561,8 +1657,14 @@ module Orb
                   last_unit: T.nilable(Float)
                 ).returns(T.attached_class)
               end
-              def self.new(first_unit:, unit_amount:, last_unit: nil); end
-
+              def self.new(
+                # Exclusive tier starting value
+                first_unit:,
+                # Amount per unit
+                unit_amount:,
+                # Inclusive tier ending value. If null, this is treated as the last tier
+                last_unit: nil
+              ); end
               sig { override.returns({first_unit: Float, unit_amount: String, last_unit: T.nilable(Float)}) }
               def to_hash; end
             end
@@ -1590,8 +1692,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -1611,14 +1717,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanTieredPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -1665,8 +1764,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -1686,14 +1789,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanTieredPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -1861,19 +1957,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             tiered_bps_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :tiered_bps
           ); end
@@ -1907,8 +2024,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredBpsPrice::Cadence) }
-            OrSymbol =
-              T.type_alias { T.any(Symbol, String, Orb::Models::PlanCreateParams::Price::NewPlanTieredBpsPrice::Cadence::TaggedSymbol) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanTieredBpsPrice::Cadence::TaggedSymbol)
@@ -1947,8 +2063,11 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(tiers:); end
-
+            def self.new(
+              # Tiers for a Graduated BPS pricing model, where usage is bucketed into specified
+              # tiers
+              tiers:
+            ); end
             sig do
               override
                 .returns(
@@ -1983,8 +2102,16 @@ module Orb
                 )
                   .returns(T.attached_class)
               end
-              def self.new(bps:, minimum_amount:, maximum_amount: nil, per_unit_maximum: nil); end
-
+              def self.new(
+                # Per-event basis point rate
+                bps:,
+                # Exclusive tier starting value
+                minimum_amount:,
+                # Inclusive tier ending value
+                maximum_amount: nil,
+                # Per unit maximum to charge
+                per_unit_maximum: nil
+              ); end
               sig do
                 override
                   .returns(
@@ -2022,8 +2149,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -2043,14 +2174,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredBpsPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanTieredBpsPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -2097,8 +2221,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -2118,14 +2246,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredBpsPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanTieredBpsPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -2284,18 +2405,39 @@ module Orb
           end
           def self.new(
             bps_config:,
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :bps
           ); end
@@ -2333,8 +2475,12 @@ module Orb
             attr_accessor :per_unit_maximum
 
             sig { params(bps: Float, per_unit_maximum: T.nilable(String)).returns(T.attached_class) }
-            def self.new(bps:, per_unit_maximum: nil); end
-
+            def self.new(
+              # Basis point take rate per event
+              bps:,
+              # Optional currency amount maximum to cap spend per event
+              per_unit_maximum: nil
+            ); end
             sig { override.returns({bps: Float, per_unit_maximum: T.nilable(String)}) }
             def to_hash; end
           end
@@ -2345,8 +2491,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBpsPrice::Cadence) }
-            OrSymbol =
-              T.type_alias { T.any(Symbol, String, Orb::Models::PlanCreateParams::Price::NewPlanBpsPrice::Cadence::TaggedSymbol) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL = T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanBpsPrice::Cadence::TaggedSymbol)
             SEMI_ANNUAL =
@@ -2383,8 +2528,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -2404,14 +2553,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBpsPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanBpsPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -2458,8 +2600,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -2479,14 +2625,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBpsPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanBpsPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -2645,18 +2784,39 @@ module Orb
           end
           def self.new(
             bulk_bps_config:,
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :bulk_bps
           ); end
@@ -2701,8 +2861,11 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(tiers:); end
-
+            def self.new(
+              # Tiers for a bulk BPS pricing model where all usage is aggregated to a single
+              # tier based on total volume
+              tiers:
+            ); end
             sig do
               override
                 .returns({tiers: T::Array[Orb::Models::PlanCreateParams::Price::NewPlanBulkBpsPrice::BulkBpsConfig::Tier]})
@@ -2726,8 +2889,14 @@ module Orb
                 params(bps: Float, maximum_amount: T.nilable(String), per_unit_maximum: T.nilable(String))
                   .returns(T.attached_class)
               end
-              def self.new(bps:, maximum_amount: nil, per_unit_maximum: nil); end
-
+              def self.new(
+                # Basis points to rate on
+                bps:,
+                # Upper bound for tier
+                maximum_amount: nil,
+                # The maximum amount to charge for any one event
+                per_unit_maximum: nil
+              ); end
               sig do
                 override.returns(
                   {
@@ -2747,8 +2916,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBulkBpsPrice::Cadence) }
-            OrSymbol =
-              T.type_alias { T.any(Symbol, String, Orb::Models::PlanCreateParams::Price::NewPlanBulkBpsPrice::Cadence::TaggedSymbol) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL = T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanBulkBpsPrice::Cadence::TaggedSymbol)
             SEMI_ANNUAL =
@@ -2790,8 +2958,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -2811,14 +2983,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBulkBpsPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanBulkBpsPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -2865,8 +3030,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -2886,14 +3055,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBulkBpsPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanBulkBpsPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -3052,18 +3214,39 @@ module Orb
           end
           def self.new(
             bulk_config:,
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :bulk
           ); end
@@ -3102,8 +3285,10 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(tiers:); end
-
+            def self.new(
+              # Bulk tiers for rating based on total usage volume
+              tiers:
+            ); end
             sig do
               override
                 .returns({tiers: T::Array[Orb::Models::PlanCreateParams::Price::NewPlanBulkPrice::BulkConfig::Tier]})
@@ -3120,8 +3305,12 @@ module Orb
               attr_accessor :maximum_units
 
               sig { params(unit_amount: String, maximum_units: T.nilable(Float)).returns(T.attached_class) }
-              def self.new(unit_amount:, maximum_units: nil); end
-
+              def self.new(
+                # Amount per unit
+                unit_amount:,
+                # Upper bound for this tier
+                maximum_units: nil
+              ); end
               sig { override.returns({unit_amount: String, maximum_units: T.nilable(Float)}) }
               def to_hash; end
             end
@@ -3133,8 +3322,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBulkPrice::Cadence) }
-            OrSymbol =
-              T.type_alias { T.any(Symbol, String, Orb::Models::PlanCreateParams::Price::NewPlanBulkPrice::Cadence::TaggedSymbol) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL = T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanBulkPrice::Cadence::TaggedSymbol)
             SEMI_ANNUAL =
@@ -3172,8 +3360,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -3193,14 +3385,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBulkPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanBulkPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -3247,8 +3432,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -3268,14 +3457,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBulkPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanBulkPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -3437,19 +3619,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             threshold_total_amount_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :threshold_total_amount
           ); end
@@ -3487,14 +3690,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanThresholdTotalAmountPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanThresholdTotalAmountPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(
@@ -3558,8 +3754,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -3579,14 +3779,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanThresholdTotalAmountPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanThresholdTotalAmountPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -3633,8 +3826,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -3654,14 +3851,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanThresholdTotalAmountPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanThresholdTotalAmountPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -3819,19 +4009,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             tiered_package_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :tiered_package
           ); end
@@ -3865,14 +4076,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredPackagePrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanTieredPackagePrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanTieredPackagePrice::Cadence::TaggedSymbol)
@@ -3919,8 +4123,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -3940,14 +4148,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredPackagePrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanTieredPackagePrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -3994,8 +4195,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -4015,14 +4220,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredPackagePrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanTieredPackagePrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -4182,19 +4380,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             tiered_with_minimum_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :tiered_with_minimum
           ); end
@@ -4230,14 +4449,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredWithMinimumPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanTieredWithMinimumPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanTieredWithMinimumPrice::Cadence::TaggedSymbol)
@@ -4295,8 +4507,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -4316,14 +4532,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredWithMinimumPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanTieredWithMinimumPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -4370,8 +4579,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -4391,14 +4604,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTieredWithMinimumPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanTieredWithMinimumPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -4556,19 +4762,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             unit_with_percent_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :unit_with_percent
           ); end
@@ -4602,14 +4829,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanUnitWithPercentPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanUnitWithPercentPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanUnitWithPercentPrice::Cadence::TaggedSymbol)
@@ -4661,8 +4881,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -4682,14 +4906,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanUnitWithPercentPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanUnitWithPercentPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -4736,8 +4953,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -4757,14 +4978,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanUnitWithPercentPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanUnitWithPercentPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -4926,19 +5140,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             package_with_allocation_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :package_with_allocation
           ); end
@@ -4976,14 +5211,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanPackageWithAllocationPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanPackageWithAllocationPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(
@@ -5047,8 +5275,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -5068,14 +5300,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanPackageWithAllocationPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanPackageWithAllocationPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -5122,8 +5347,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -5143,14 +5372,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanPackageWithAllocationPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanPackageWithAllocationPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -5310,19 +5532,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             tiered_with_proration_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :tiered_with_proration
           ); end
@@ -5358,14 +5601,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTierWithProrationPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanTierWithProrationPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanTierWithProrationPrice::Cadence::TaggedSymbol)
@@ -5423,8 +5659,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -5444,14 +5684,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTierWithProrationPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanTierWithProrationPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -5498,8 +5731,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -5519,14 +5756,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanTierWithProrationPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanTierWithProrationPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -5686,19 +5916,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             unit_with_proration_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :unit_with_proration
           ); end
@@ -5734,14 +5985,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanUnitWithProrationPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanUnitWithProrationPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanUnitWithProrationPrice::Cadence::TaggedSymbol)
@@ -5799,8 +6043,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -5820,14 +6068,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanUnitWithProrationPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanUnitWithProrationPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -5874,8 +6115,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -5895,14 +6140,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanUnitWithProrationPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanUnitWithProrationPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -6062,19 +6300,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
             grouped_allocation_config:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :grouped_allocation
           ); end
@@ -6110,14 +6369,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedAllocationPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanGroupedAllocationPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanGroupedAllocationPrice::Cadence::TaggedSymbol)
@@ -6175,8 +6427,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -6196,14 +6452,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedAllocationPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanGroupedAllocationPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -6250,8 +6499,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -6271,14 +6524,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedAllocationPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanGroupedAllocationPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -6440,19 +6686,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
             grouped_with_prorated_minimum_config:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :grouped_with_prorated_minimum
           ); end
@@ -6490,14 +6757,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithProratedMinimumPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithProratedMinimumPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(
@@ -6561,8 +6821,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -6582,14 +6846,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithProratedMinimumPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithProratedMinimumPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -6636,8 +6893,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -6657,14 +6918,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithProratedMinimumPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithProratedMinimumPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -6826,19 +7080,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
             grouped_with_metered_minimum_config:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :grouped_with_metered_minimum
           ); end
@@ -6876,14 +7151,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithMeteredMinimumPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithMeteredMinimumPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(
@@ -6947,8 +7215,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -6968,14 +7240,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithMeteredMinimumPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithMeteredMinimumPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -7022,8 +7287,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -7043,14 +7312,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithMeteredMinimumPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanGroupedWithMeteredMinimumPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -7212,19 +7474,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
             matrix_with_display_name_config:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :matrix_with_display_name
           ); end
@@ -7262,14 +7545,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanMatrixWithDisplayNamePrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanMatrixWithDisplayNamePrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(
@@ -7333,8 +7609,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -7354,14 +7634,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanMatrixWithDisplayNamePrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanMatrixWithDisplayNamePrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -7408,8 +7681,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -7429,14 +7706,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanMatrixWithDisplayNamePrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanMatrixWithDisplayNamePrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -7597,18 +7867,39 @@ module Orb
           end
           def self.new(
             bulk_with_proration_config:,
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :bulk_with_proration
           ); end
@@ -7644,14 +7935,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBulkWithProrationPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanBulkWithProrationPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(:annual, Orb::Models::PlanCreateParams::Price::NewPlanBulkWithProrationPrice::Cadence::TaggedSymbol)
@@ -7709,8 +7993,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -7730,14 +8018,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBulkWithProrationPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanBulkWithProrationPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -7784,8 +8065,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -7805,14 +8090,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanBulkWithProrationPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanBulkWithProrationPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -7974,19 +8252,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
             grouped_tiered_package_config:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :grouped_tiered_package
           ); end
@@ -8024,14 +8323,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedTieredPackagePrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanGroupedTieredPackagePrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(
@@ -8095,8 +8387,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -8116,14 +8412,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedTieredPackagePrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanGroupedTieredPackagePrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -8170,8 +8459,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -8191,14 +8484,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanGroupedTieredPackagePrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanGroupedTieredPackagePrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -8360,19 +8646,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
             max_group_tiered_package_config:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :max_group_tiered_package
           ); end
@@ -8410,14 +8717,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanMaxGroupTieredPackagePrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanMaxGroupTieredPackagePrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(
@@ -8481,8 +8781,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -8502,14 +8806,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanMaxGroupTieredPackagePrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanMaxGroupTieredPackagePrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -8556,8 +8853,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -8577,14 +8878,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanMaxGroupTieredPackagePrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanMaxGroupTieredPackagePrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -8750,19 +9044,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             scalable_matrix_with_unit_pricing_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :scalable_matrix_with_unit_pricing
           ); end
@@ -8800,14 +9115,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithUnitPricingPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithUnitPricingPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(
@@ -8871,8 +9179,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -8892,14 +9204,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithUnitPricingPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithUnitPricingPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -8946,8 +9251,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -8967,14 +9276,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithUnitPricingPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithUnitPricingPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -9140,19 +9442,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
             scalable_matrix_with_tiered_pricing_config:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :scalable_matrix_with_tiered_pricing
           ); end
@@ -9190,14 +9513,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithTieredPricingPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithTieredPricingPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(
@@ -9261,8 +9577,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -9282,14 +9602,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithTieredPricingPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithTieredPricingPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -9336,8 +9649,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -9357,14 +9674,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithTieredPricingPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanScalableMatrixWithTieredPricingPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -9526,19 +9836,40 @@ module Orb
               .returns(T.attached_class)
           end
           def self.new(
+            # The cadence to bill for this price on.
             cadence:,
             cumulative_grouped_bulk_config:,
+            # The id of the item the price will be associated with.
             item_id:,
+            # The name of the price.
             name:,
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
             billable_metric_id: nil,
+            # If the Price represents a fixed cost, the price will be billed in-advance if
+            # this is true, and in-arrears if this is false.
             billed_in_advance: nil,
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
             billing_cycle_configuration: nil,
+            # The per unit conversion rate of the price currency to the invoicing currency.
             conversion_rate: nil,
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
             currency: nil,
+            # An alias for the price.
             external_price_id: nil,
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
             fixed_price_quantity: nil,
+            # The property used to group this price on an invoice
             invoice_grouping_key: nil,
+            # 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,
+            # 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,
             model_type: :cumulative_grouped_bulk
           ); end
@@ -9576,14 +9907,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanCumulativeGroupedBulkPrice::Cadence) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::PlanCreateParams::Price::NewPlanCumulativeGroupedBulkPrice::Cadence::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             ANNUAL =
               T.let(
@@ -9647,8 +9971,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -9668,14 +9996,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanCumulativeGroupedBulkPrice::BillingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanCumulativeGroupedBulkPrice::BillingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -9722,8 +10043,12 @@ module Orb
               )
                 .returns(T.attached_class)
             end
-            def self.new(duration:, duration_unit:); end
-
+            def self.new(
+              # The duration of the billing period.
+              duration:,
+              # The unit of billing period duration.
+              duration_unit:
+            ); end
             sig do
               override
                 .returns(
@@ -9743,14 +10068,7 @@ module Orb
                 T.type_alias do
                   T.all(Symbol, Orb::Models::PlanCreateParams::Price::NewPlanCumulativeGroupedBulkPrice::InvoicingCycleConfiguration::DurationUnit)
                 end
-              OrSymbol =
-                T.type_alias do
-                  T.any(
-                    Symbol,
-                    String,
-                    Orb::Models::PlanCreateParams::Price::NewPlanCumulativeGroupedBulkPrice::InvoicingCycleConfiguration::DurationUnit::TaggedSymbol
-                  )
-                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
 
               DAY =
                 T.let(
@@ -9791,7 +10109,7 @@ module Orb
         extend Orb::Internal::Type::Enum
 
         TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::PlanCreateParams::Status) }
-        OrSymbol = T.type_alias { T.any(Symbol, String, Orb::Models::PlanCreateParams::Status::TaggedSymbol) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         ACTIVE = T.let(:active, Orb::Models::PlanCreateParams::Status::TaggedSymbol)
         DRAFT = T.let(:draft, Orb::Models::PlanCreateParams::Status::TaggedSymbol)