orb-billing 1.13.0 → 1.15.0

data/lib/orb/models/plan_fetch_params.rb

@@ -7,7 +7,13 @@ module Orb
       extend Orb::Internal::Type::RequestParameters::Converter
       include Orb::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute plan_id
+      #
+      #   @return [String]
+      required :plan_id, String
+
+      # @!method initialize(plan_id:, request_options: {})
+      #   @param plan_id [String]
       #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/orb/models/plan_update_params.rb

@@ -7,6 +7,17 @@ module Orb
       extend Orb::Internal::Type::RequestParameters::Converter
       include Orb::Internal::Type::RequestParameters
 
+      # @!attribute plan_id
+      #
+      #   @return [String]
+      required :plan_id, String
+
+      # @!attribute description
+      #   An optional user-defined description of the plan.
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
       # @!attribute external_plan_id
       #   An optional user-defined ID for this plan resource, used throughout the system
       #   as an alias for this Plan. Use this field to identify a plan by an existing
@@ -23,10 +34,14 @@ module Orb
       #   @return [Hash{Symbol=>String, nil}, nil]
       optional :metadata, Orb::Internal::Type::HashOf[String, nil?: true], nil?: true
 
-      # @!method initialize(external_plan_id: nil, metadata: nil, request_options: {})
+      # @!method initialize(plan_id:, description: nil, external_plan_id: nil, metadata: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Orb::Models::PlanUpdateParams} for more details.
       #
+      #   @param plan_id [String]
+      #
+      #   @param description [String, nil] An optional user-defined description of the plan.
+      #
       #   @param external_plan_id [String, nil] An optional user-defined ID for this plan resource, used throughout the system a
       #
       #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed

data/lib/orb/models/plan_version.rb

@@ -8,7 +8,7 @@ module Orb
       #   Adjustments for this plan. If the plan has phases, this includes adjustments
       #   across all phases of the plan.
       #
-      #   @return [Array<Orb::Models::PlanPhaseUsageDiscountAdjustment, Orb::Models::PlanPhaseAmountDiscountAdjustment, Orb::Models::PlanPhasePercentageDiscountAdjustment, Orb::Models::PlanPhaseMinimumAdjustment, Orb::Models::PlanPhaseMaximumAdjustment>]
+      #   @return [Array<Orb::Models::PlanPhaseUsageDiscountAdjustment, Orb::Models::PlanPhaseAmountDiscountAdjustment, Orb::Models::PlanPhasePercentageDiscountAdjustment, Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount, Orb::Models::PlanPhaseMinimumAdjustment, Orb::Models::PlanPhaseMaximumAdjustment>]
       required :adjustments, -> { Orb::Internal::Type::ArrayOf[union: Orb::PlanVersion::Adjustment] }
 
       # @!attribute created_at
@@ -25,7 +25,7 @@ module Orb
       #   Prices for this plan. If the plan has phases, this includes prices across all
       #   phases of the plan.
       #
-      #   @return [Array<Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput>]
+      #   @return [Array<Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::MatrixWithThresholdDiscounts, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::DailyCreditAllowance, Orb::Models::Price::MeteredAllowance, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput>]
       required :prices, -> { Orb::Internal::Type::ArrayOf[union: Orb::Price] }
 
       # @!attribute version
@@ -40,13 +40,13 @@ module Orb
       #   The PlanVersion resource represents the prices and adjustments present on a
       #   specific version of a plan.
       #
-      #   @param adjustments [Array<Orb::Models::PlanPhaseUsageDiscountAdjustment, Orb::Models::PlanPhaseAmountDiscountAdjustment, Orb::Models::PlanPhasePercentageDiscountAdjustment, Orb::Models::PlanPhaseMinimumAdjustment, Orb::Models::PlanPhaseMaximumAdjustment>] Adjustments for this plan. If the plan has phases, this includes adjustments acr
+      #   @param adjustments [Array<Orb::Models::PlanPhaseUsageDiscountAdjustment, Orb::Models::PlanPhaseAmountDiscountAdjustment, Orb::Models::PlanPhasePercentageDiscountAdjustment, Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount, Orb::Models::PlanPhaseMinimumAdjustment, Orb::Models::PlanPhaseMaximumAdjustment>] Adjustments for this plan. If the plan has phases, this includes adjustments acr
       #
       #   @param created_at [Time]
       #
       #   @param plan_phases [Array<Orb::Models::PlanVersionPhase>, nil]
       #
-      #   @param prices [Array<Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput>] Prices for this plan. If the plan has phases, this includes prices across all ph
+      #   @param prices [Array<Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::MatrixWithThresholdDiscounts, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::DailyCreditAllowance, Orb::Models::Price::MeteredAllowance, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput>] Prices for this plan. If the plan has phases, this includes prices across all ph
       #
       #   @param version [Integer]
 
@@ -61,12 +61,193 @@ module Orb
 
         variant :percentage_discount, -> { Orb::PlanPhasePercentageDiscountAdjustment }
 
+        variant :tiered_percentage_discount, -> { Orb::PlanVersion::Adjustment::TieredPercentageDiscount }
+
         variant :minimum, -> { Orb::PlanPhaseMinimumAdjustment }
 
         variant :maximum, -> { Orb::PlanPhaseMaximumAdjustment }
 
+        class TieredPercentageDiscount < Orb::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute adjustment_type
+          #
+          #   @return [Symbol, :tiered_percentage_discount]
+          required :adjustment_type, const: :tiered_percentage_discount
+
+          # @!attribute applies_to_price_ids
+          #   @deprecated
+          #
+          #   The price IDs that this adjustment applies to.
+          #
+          #   @return [Array<String>]
+          required :applies_to_price_ids, Orb::Internal::Type::ArrayOf[String]
+
+          # @!attribute filters
+          #   The filters that determine which prices to apply this adjustment to.
+          #
+          #   @return [Array<Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Filter>]
+          required :filters,
+                   -> { Orb::Internal::Type::ArrayOf[Orb::PlanVersion::Adjustment::TieredPercentageDiscount::Filter] }
+
+          # @!attribute is_invoice_level
+          #   True for adjustments that apply to an entire invoice, false for adjustments that
+          #   apply to only one price.
+          #
+          #   @return [Boolean]
+          required :is_invoice_level, Orb::Internal::Type::Boolean
+
+          # @!attribute plan_phase_order
+          #   The plan phase in which this adjustment is active.
+          #
+          #   @return [Integer, nil]
+          required :plan_phase_order, Integer, nil?: true
+
+          # @!attribute reason
+          #   The reason for the adjustment.
+          #
+          #   @return [String, nil]
+          required :reason, String, nil?: true
+
+          # @!attribute replaces_adjustment_id
+          #   The adjustment id this adjustment replaces. This adjustment will take the place
+          #   of the replaced adjustment in plan version migrations.
+          #
+          #   @return [String, nil]
+          required :replaces_adjustment_id, String, nil?: true
+
+          # @!attribute tiers
+          #   The ordered, contiguous bands of cumulative eligible spend, each discounted at
+          #   its own percentage (progressive fill-a-tier), applied to the prices this
+          #   adjustment covers in a given billing period.
+          #
+          #   @return [Array<Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Tier>]
+          required :tiers,
+                   -> { Orb::Internal::Type::ArrayOf[Orb::PlanVersion::Adjustment::TieredPercentageDiscount::Tier] }
+
+          # @!method initialize(id:, applies_to_price_ids:, filters:, is_invoice_level:, plan_phase_order:, reason:, replaces_adjustment_id:, tiers:, adjustment_type: :tiered_percentage_discount)
+          #   Some parameter documentations has been truncated, see
+          #   {Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount} for more
+          #   details.
+          #
+          #   @param id [String]
+          #
+          #   @param applies_to_price_ids [Array<String>] The price IDs that this adjustment applies to.
+          #
+          #   @param filters [Array<Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Filter>] The filters that determine which prices to apply this adjustment to.
+          #
+          #   @param is_invoice_level [Boolean] True for adjustments that apply to an entire invoice, false for adjustments that
+          #
+          #   @param plan_phase_order [Integer, nil] The plan phase in which this adjustment is active.
+          #
+          #   @param reason [String, nil] The reason for the adjustment.
+          #
+          #   @param replaces_adjustment_id [String, nil] The adjustment id this adjustment replaces. This adjustment will take the place
+          #
+          #   @param tiers [Array<Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Tier>] The ordered, contiguous bands of cumulative eligible spend, each discounted at i
+          #
+          #   @param adjustment_type [Symbol, :tiered_percentage_discount]
+
+          class Filter < Orb::Internal::Type::BaseModel
+            # @!attribute field
+            #   The property of the price to filter on.
+            #
+            #   @return [Symbol, Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Filter::Field]
+            required :field, enum: -> { Orb::PlanVersion::Adjustment::TieredPercentageDiscount::Filter::Field }
+
+            # @!attribute operator
+            #   Should prices that match the filter be included or excluded.
+            #
+            #   @return [Symbol, Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Filter::Operator]
+            required :operator, enum: -> { Orb::PlanVersion::Adjustment::TieredPercentageDiscount::Filter::Operator }
+
+            # @!attribute values
+            #   The IDs or values that match this filter.
+            #
+            #   @return [Array<String>]
+            required :values, Orb::Internal::Type::ArrayOf[String]
+
+            # @!method initialize(field:, operator:, values:)
+            #   @param field [Symbol, Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Filter::Field] The property of the price to filter on.
+            #
+            #   @param operator [Symbol, Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Filter::Operator] Should prices that match the filter be included or excluded.
+            #
+            #   @param values [Array<String>] The IDs or values that match this filter.
+
+            # The property of the price to filter on.
+            #
+            # @see Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Filter#field
+            module Field
+              extend Orb::Internal::Type::Enum
+
+              PRICE_ID = :price_id
+              ITEM_ID = :item_id
+              PRICE_TYPE = :price_type
+              CURRENCY = :currency
+              PRICING_UNIT_ID = :pricing_unit_id
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Should prices that match the filter be included or excluded.
+            #
+            # @see Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Filter#operator
+            module Operator
+              extend Orb::Internal::Type::Enum
+
+              INCLUDES = :includes
+              EXCLUDES = :excludes
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          class Tier < Orb::Internal::Type::BaseModel
+            # @!attribute lower_bound
+            #   Exclusive lower bound of cumulative spend for this tier.
+            #
+            #   @return [Float]
+            required :lower_bound, Float
+
+            # @!attribute percentage
+            #   The percentage (between 0 and 1) discounted from spend that falls within this
+            #   tier.
+            #
+            #   @return [Float]
+            required :percentage, Float
+
+            # @!attribute upper_bound
+            #   Inclusive upper bound of cumulative spend for this tier; null for the final
+            #   open-ended tier.
+            #
+            #   @return [Float, nil]
+            optional :upper_bound, Float, nil?: true
+
+            # @!method initialize(lower_bound:, percentage:, upper_bound: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount::Tier} for more
+            #   details.
+            #
+            #   One band of a tiered percentage discount. Bounds are denominated in the
+            #   discount's currency. `lower_bound` is the exclusive start of the band and
+            #   `upper_bound` is the inclusive end; `upper_bound` is null only for the
+            #   open-ended final tier.
+            #
+            #   @param lower_bound [Float] Exclusive lower bound of cumulative spend for this tier.
+            #
+            #   @param percentage [Float] The percentage (between 0 and 1) discounted from spend that falls within this ti
+            #
+            #   @param upper_bound [Float, nil] Inclusive upper bound of cumulative spend for this tier; null for the final open
+          end
+        end
+
         # @!method self.variants
-        #   @return [Array(Orb::Models::PlanPhaseUsageDiscountAdjustment, Orb::Models::PlanPhaseAmountDiscountAdjustment, Orb::Models::PlanPhasePercentageDiscountAdjustment, Orb::Models::PlanPhaseMinimumAdjustment, Orb::Models::PlanPhaseMaximumAdjustment)]
+        #   @return [Array(Orb::Models::PlanPhaseUsageDiscountAdjustment, Orb::Models::PlanPhaseAmountDiscountAdjustment, Orb::Models::PlanPhasePercentageDiscountAdjustment, Orb::Models::PlanVersion::Adjustment::TieredPercentageDiscount, Orb::Models::PlanPhaseMinimumAdjustment, Orb::Models::PlanPhaseMaximumAdjustment)]
       end
     end
   end

data/lib/orb/models/plans/external_plan_id_fetch_params.rb

@@ -8,7 +8,13 @@ module Orb
         extend Orb::Internal::Type::RequestParameters::Converter
         include Orb::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute external_plan_id
+        #
+        #   @return [String]
+        required :external_plan_id, String
+
+        # @!method initialize(external_plan_id:, request_options: {})
+        #   @param external_plan_id [String]
         #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/orb/models/plans/external_plan_id_update_params.rb

@@ -8,6 +8,17 @@ module Orb
         extend Orb::Internal::Type::RequestParameters::Converter
         include Orb::Internal::Type::RequestParameters
 
+        # @!attribute other_external_plan_id
+        #
+        #   @return [String]
+        required :other_external_plan_id, String
+
+        # @!attribute description
+        #   An optional user-defined description of the plan.
+        #
+        #   @return [String, nil]
+        optional :description, String, nil?: true
+
         # @!attribute external_plan_id
         #   An optional user-defined ID for this plan resource, used throughout the system
         #   as an alias for this Plan. Use this field to identify a plan by an existing
@@ -24,10 +35,14 @@ module Orb
         #   @return [Hash{Symbol=>String, nil}, nil]
         optional :metadata, Orb::Internal::Type::HashOf[String, nil?: true], nil?: true
 
-        # @!method initialize(external_plan_id: nil, metadata: nil, request_options: {})
+        # @!method initialize(other_external_plan_id:, description: nil, external_plan_id: nil, metadata: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::Plans::ExternalPlanIDUpdateParams} for more details.
         #
+        #   @param other_external_plan_id [String]
+        #
+        #   @param description [String, nil] An optional user-defined description of the plan.
+        #
         #   @param external_plan_id [String, nil] An optional user-defined ID for this plan resource, used throughout the system a
         #
         #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed

data/lib/orb/models/plans/migration_cancel_params.rb

@@ -13,8 +13,14 @@ module Orb
         #   @return [String]
         required :plan_id, String
 
-        # @!method initialize(plan_id:, request_options: {})
+        # @!attribute migration_id
+        #
+        #   @return [String]
+        required :migration_id, String
+
+        # @!method initialize(plan_id:, migration_id:, request_options: {})
         #   @param plan_id [String]
+        #   @param migration_id [String]
         #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/orb/models/plans/migration_cancel_response.rb

@@ -6,11 +6,14 @@ module Orb
       # @see Orb::Resources::Plans::Migrations#cancel
       class MigrationCancelResponse < Orb::Internal::Type::BaseModel
         # @!attribute id
+        #   Unique identifier for this plan version change.
         #
         #   @return [String]
         required :id, String
 
         # @!attribute effective_time
+        #   When the migration takes effect. Can be a specific date/time, or 'end_of_term'
+        #   when scheduled to be at the end of the current billing period.
         #
         #   @return [Date, Time, Symbol, Orb::Models::Plans::MigrationCancelResponse::EffectiveTime, nil]
         required :effective_time,
@@ -18,21 +21,33 @@ module Orb
                  nil?: true
 
         # @!attribute plan_id
+        #   The ID of the plan being migrated.
         #
         #   @return [String]
         required :plan_id, String
 
         # @!attribute status
+        #   Current status of the migration: 'not_started', 'in_progress', 'completed',
+        #   'action_needed', or 'canceled'.
         #
         #   @return [Symbol, Orb::Models::Plans::MigrationCancelResponse::Status]
         required :status, enum: -> { Orb::Models::Plans::MigrationCancelResponse::Status }
 
         # @!method initialize(id:, effective_time:, plan_id:, status:)
-        #   @param id [String]
-        #   @param effective_time [Date, Time, Symbol, Orb::Models::Plans::MigrationCancelResponse::EffectiveTime, nil]
-        #   @param plan_id [String]
-        #   @param status [Symbol, Orb::Models::Plans::MigrationCancelResponse::Status]
+        #   Some parameter documentations has been truncated, see
+        #   {Orb::Models::Plans::MigrationCancelResponse} for more details.
+        #
+        #   @param id [String] Unique identifier for this plan version change.
+        #
+        #   @param effective_time [Date, Time, Symbol, Orb::Models::Plans::MigrationCancelResponse::EffectiveTime, nil] When the migration takes effect. Can be a specific date/time, or 'end_of_term' w
+        #
+        #   @param plan_id [String] The ID of the plan being migrated.
+        #
+        #   @param status [Symbol, Orb::Models::Plans::MigrationCancelResponse::Status] Current status of the migration: 'not_started', 'in_progress', 'completed', 'act
 
+        # When the migration takes effect. Can be a specific date/time, or 'end_of_term'
+        # when scheduled to be at the end of the current billing period.
+        #
         # @see Orb::Models::Plans::MigrationCancelResponse#effective_time
         module EffectiveTime
           extend Orb::Internal::Type::Union
@@ -57,6 +72,9 @@ module Orb
           # @!endgroup
         end
 
+        # Current status of the migration: 'not_started', 'in_progress', 'completed',
+        # 'action_needed', or 'canceled'.
+        #
         # @see Orb::Models::Plans::MigrationCancelResponse#status
         module Status
           extend Orb::Internal::Type::Enum

data/lib/orb/models/plans/migration_list_params.rb

@@ -8,6 +8,11 @@ module Orb
         extend Orb::Internal::Type::RequestParameters::Converter
         include Orb::Internal::Type::RequestParameters
 
+        # @!attribute plan_id
+        #
+        #   @return [String]
+        required :plan_id, String
+
         # @!attribute cursor
         #   Cursor for pagination. This can be populated by the `next_cursor` value returned
         #   from the initial request.
@@ -21,10 +26,12 @@ module Orb
         #   @return [Integer, nil]
         optional :limit, Integer
 
-        # @!method initialize(cursor: nil, limit: nil, request_options: {})
+        # @!method initialize(plan_id:, cursor: nil, limit: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::Plans::MigrationListParams} for more details.
         #
+        #   @param plan_id [String]
+        #
         #   @param cursor [String, nil] Cursor for pagination. This can be populated by the `next_cursor` value returned
         #
         #   @param limit [Integer] The number of items to fetch. Defaults to 20.

data/lib/orb/models/plans/migration_list_response.rb

@@ -6,11 +6,14 @@ module Orb
       # @see Orb::Resources::Plans::Migrations#list
       class MigrationListResponse < Orb::Internal::Type::BaseModel
         # @!attribute id
+        #   Unique identifier for this plan version change.
         #
         #   @return [String]
         required :id, String
 
         # @!attribute effective_time
+        #   When the migration takes effect. Can be a specific date/time, or 'end_of_term'
+        #   when scheduled to be at the end of the current billing period.
         #
         #   @return [Date, Time, Symbol, Orb::Models::Plans::MigrationListResponse::EffectiveTime, nil]
         required :effective_time,
@@ -18,21 +21,33 @@ module Orb
                  nil?: true
 
         # @!attribute plan_id
+        #   The ID of the plan being migrated.
         #
         #   @return [String]
         required :plan_id, String
 
         # @!attribute status
+        #   Current status of the migration: 'not_started', 'in_progress', 'completed',
+        #   'action_needed', or 'canceled'.
         #
         #   @return [Symbol, Orb::Models::Plans::MigrationListResponse::Status]
         required :status, enum: -> { Orb::Models::Plans::MigrationListResponse::Status }
 
         # @!method initialize(id:, effective_time:, plan_id:, status:)
-        #   @param id [String]
-        #   @param effective_time [Date, Time, Symbol, Orb::Models::Plans::MigrationListResponse::EffectiveTime, nil]
-        #   @param plan_id [String]
-        #   @param status [Symbol, Orb::Models::Plans::MigrationListResponse::Status]
+        #   Some parameter documentations has been truncated, see
+        #   {Orb::Models::Plans::MigrationListResponse} for more details.
+        #
+        #   @param id [String] Unique identifier for this plan version change.
+        #
+        #   @param effective_time [Date, Time, Symbol, Orb::Models::Plans::MigrationListResponse::EffectiveTime, nil] When the migration takes effect. Can be a specific date/time, or 'end_of_term' w
+        #
+        #   @param plan_id [String] The ID of the plan being migrated.
+        #
+        #   @param status [Symbol, Orb::Models::Plans::MigrationListResponse::Status] Current status of the migration: 'not_started', 'in_progress', 'completed', 'act
 
+        # When the migration takes effect. Can be a specific date/time, or 'end_of_term'
+        # when scheduled to be at the end of the current billing period.
+        #
         # @see Orb::Models::Plans::MigrationListResponse#effective_time
         module EffectiveTime
           extend Orb::Internal::Type::Union
@@ -57,6 +72,9 @@ module Orb
           # @!endgroup
         end
 
+        # Current status of the migration: 'not_started', 'in_progress', 'completed',
+        # 'action_needed', or 'canceled'.
+        #
         # @see Orb::Models::Plans::MigrationListResponse#status
         module Status
           extend Orb::Internal::Type::Enum

data/lib/orb/models/plans/migration_retrieve_params.rb

@@ -13,8 +13,14 @@ module Orb
         #   @return [String]
         required :plan_id, String
 
-        # @!method initialize(plan_id:, request_options: {})
+        # @!attribute migration_id
+        #
+        #   @return [String]
+        required :migration_id, String
+
+        # @!method initialize(plan_id:, migration_id:, request_options: {})
         #   @param plan_id [String]
+        #   @param migration_id [String]
         #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/orb/models/plans/migration_retrieve_response.rb

@@ -6,11 +6,14 @@ module Orb
       # @see Orb::Resources::Plans::Migrations#retrieve
       class MigrationRetrieveResponse < Orb::Internal::Type::BaseModel
         # @!attribute id
+        #   Unique identifier for this plan version change.
         #
         #   @return [String]
         required :id, String
 
         # @!attribute effective_time
+        #   When the migration takes effect. Can be a specific date/time, or 'end_of_term'
+        #   when scheduled to be at the end of the current billing period.
         #
         #   @return [Date, Time, Symbol, Orb::Models::Plans::MigrationRetrieveResponse::EffectiveTime, nil]
         required :effective_time,
@@ -18,21 +21,33 @@ module Orb
                  nil?: true
 
         # @!attribute plan_id
+        #   The ID of the plan being migrated.
         #
         #   @return [String]
         required :plan_id, String
 
         # @!attribute status
+        #   Current status of the migration: 'not_started', 'in_progress', 'completed',
+        #   'action_needed', or 'canceled'.
         #
         #   @return [Symbol, Orb::Models::Plans::MigrationRetrieveResponse::Status]
         required :status, enum: -> { Orb::Models::Plans::MigrationRetrieveResponse::Status }
 
         # @!method initialize(id:, effective_time:, plan_id:, status:)
-        #   @param id [String]
-        #   @param effective_time [Date, Time, Symbol, Orb::Models::Plans::MigrationRetrieveResponse::EffectiveTime, nil]
-        #   @param plan_id [String]
-        #   @param status [Symbol, Orb::Models::Plans::MigrationRetrieveResponse::Status]
+        #   Some parameter documentations has been truncated, see
+        #   {Orb::Models::Plans::MigrationRetrieveResponse} for more details.
+        #
+        #   @param id [String] Unique identifier for this plan version change.
+        #
+        #   @param effective_time [Date, Time, Symbol, Orb::Models::Plans::MigrationRetrieveResponse::EffectiveTime, nil] When the migration takes effect. Can be a specific date/time, or 'end_of_term' w
+        #
+        #   @param plan_id [String] The ID of the plan being migrated.
+        #
+        #   @param status [Symbol, Orb::Models::Plans::MigrationRetrieveResponse::Status] Current status of the migration: 'not_started', 'in_progress', 'completed', 'act
 
+        # When the migration takes effect. Can be a specific date/time, or 'end_of_term'
+        # when scheduled to be at the end of the current billing period.
+        #
         # @see Orb::Models::Plans::MigrationRetrieveResponse#effective_time
         module EffectiveTime
           extend Orb::Internal::Type::Union
@@ -57,6 +72,9 @@ module Orb
           # @!endgroup
         end
 
+        # Current status of the migration: 'not_started', 'in_progress', 'completed',
+        # 'action_needed', or 'canceled'.
+        #
         # @see Orb::Models::Plans::MigrationRetrieveResponse#status
         module Status
           extend Orb::Internal::Type::Enum