orb-billing 1.13.0 → 1.14.0

data/lib/orb/resources/customers/credits/ledger.rb

@@ -137,9 +137,6 @@ module Orb
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {Orb::Models::Customers::Credits::LedgerCreateEntryParams} for more details.
-          #
           # This endpoint allows you to create a new ledger entry for a specified customer's
           # balance. This can be used to increment balance, deduct credits, and change the
           # expiry date of existing credits.
@@ -190,7 +187,9 @@ module Orb
           # also generate a one-off invoice for the customer for the credits pre-purchase.
           # Note that you _must_ provide the `per_unit_cost_basis`, since the total charges
           # on the invoice are calculated by multiplying the cost basis with the number of
-          # credit units added.
+          # credit units added. If you invoice or handle payment of credits outside of Orb
+          # (i.e. marketplace customers), set `mark_as_paid` in the `invoice_settings` to
+          # `true` to prevent duplicate invoicing effects.
           #
           # - if `per_unit_cost_basis` is greater than zero, an invoice will be generated
           #   and `invoice_settings` must be included
@@ -256,36 +255,10 @@ module Orb
           # that was originally decremented from, and `amount` indicates how many credits to
           # return to the customer, up to the block's initial balance.
           #
-          # @overload create_entry(customer_id, amount:, entry_type:, target_expiry_date:, block_id:, currency: nil, description: nil, effective_date: nil, expiry_date: nil, filters: nil, invoice_settings: nil, metadata: nil, per_unit_cost_basis: nil, void_reason: nil, request_options: {})
+          # @overload create_entry(customer_id, body:, request_options: {})
           #
           # @param customer_id [String]
-          #
-          # @param amount [Float] The number of credits to effect. Note that this is required for increment, decre
-          #
-          # @param entry_type [Symbol, Orb::Models::Customers::Credits::LedgerCreateEntryParams::EntryType]
-          #
-          # @param target_expiry_date [Date] A future date (specified in YYYY-MM-DD format) used for expiration change, denot
-          #
-          # @param block_id [String] The ID of the block to reverse a decrement from.
-          #
-          # @param currency [String, nil] The currency or custom pricing unit to use for this ledger entry. If this is a r
-          #
-          # @param description [String, nil] Optional metadata that can be specified when adding ledger results via the API.
-          #
-          # @param effective_date [Time, nil] An ISO 8601 format date that denotes when this credit balance should become avai
-          #
-          # @param expiry_date [Time, nil] An ISO 8601 format date that identifies the origination credit block to expire
-          #
-          # @param filters [Array<Orb::Models::Customers::Credits::LedgerCreateEntryParams::Filter>, nil] Optional filter to specify which items this credit block applies to. If not spec
-          #
-          # @param invoice_settings [Orb::Models::Customers::Credits::LedgerCreateEntryParams::InvoiceSettings, nil] Passing `invoice_settings` automatically generates an invoice for the newly adde
-          #
-          # @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
-          #
-          # @param per_unit_cost_basis [String, nil] Can only be specified when entry_type=increment. How much, in the customer's cur
-          #
-          # @param void_reason [Symbol, Orb::Models::Customers::Credits::LedgerCreateEntryParams::VoidReason, nil] Can only be specified when `entry_type=void`. The reason for the void.
-          #
+          # @param body [Orb::Models::Customers::Credits::LedgerCreateEntryParams::Body::Increment, Orb::Models::Customers::Credits::LedgerCreateEntryParams::Body::Decrement, Orb::Models::Customers::Credits::LedgerCreateEntryParams::Body::ExpirationChange, Orb::Models::Customers::Credits::LedgerCreateEntryParams::Body::Void, Orb::Models::Customers::Credits::LedgerCreateEntryParams::Body::Amendment]
           # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Orb::Models::Customers::Credits::IncrementLedgerEntry, Orb::Models::Customers::Credits::DecrementLedgerEntry, Orb::Models::Customers::Credits::ExpirationChangeLedgerEntry, Orb::Models::Customers::Credits::CreditBlockExpiryLedgerEntry, Orb::Models::Customers::Credits::VoidLedgerEntry, Orb::Models::Customers::Credits::VoidInitiatedLedgerEntry, Orb::Models::Customers::Credits::AmendmentLedgerEntry]
@@ -296,16 +269,12 @@ module Orb
             @client.request(
               method: :post,
               path: ["customers/%1$s/credits/ledger_entry", customer_id],
-              body: parsed,
+              body: parsed[:body],
               model: Orb::Models::Customers::Credits::LedgerCreateEntryResponse,
               options: options
             )
           end
 
-          # Some parameter documentations has been truncated, see
-          # {Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams} for more
-          # details.
-          #
           # This endpoint allows you to create a new ledger entry for a specified customer's
           # balance. This can be used to increment balance, deduct credits, and change the
           # expiry date of existing credits.
@@ -356,7 +325,9 @@ module Orb
           # also generate a one-off invoice for the customer for the credits pre-purchase.
           # Note that you _must_ provide the `per_unit_cost_basis`, since the total charges
           # on the invoice are calculated by multiplying the cost basis with the number of
-          # credit units added.
+          # credit units added. If you invoice or handle payment of credits outside of Orb
+          # (i.e. marketplace customers), set `mark_as_paid` in the `invoice_settings` to
+          # `true` to prevent duplicate invoicing effects.
           #
           # - if `per_unit_cost_basis` is greater than zero, an invoice will be generated
           #   and `invoice_settings` must be included
@@ -422,36 +393,10 @@ module Orb
           # that was originally decremented from, and `amount` indicates how many credits to
           # return to the customer, up to the block's initial balance.
           #
-          # @overload create_entry_by_external_id(external_customer_id, amount:, entry_type:, target_expiry_date:, block_id:, currency: nil, description: nil, effective_date: nil, expiry_date: nil, filters: nil, invoice_settings: nil, metadata: nil, per_unit_cost_basis: nil, void_reason: nil, request_options: {})
+          # @overload create_entry_by_external_id(external_customer_id, body:, request_options: {})
           #
           # @param external_customer_id [String]
-          #
-          # @param amount [Float] The number of credits to effect. Note that this is required for increment, decre
-          #
-          # @param entry_type [Symbol, Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::EntryType]
-          #
-          # @param target_expiry_date [Date] A future date (specified in YYYY-MM-DD format) used for expiration change, denot
-          #
-          # @param block_id [String] The ID of the block to reverse a decrement from.
-          #
-          # @param currency [String, nil] The currency or custom pricing unit to use for this ledger entry. If this is a r
-          #
-          # @param description [String, nil] Optional metadata that can be specified when adding ledger results via the API.
-          #
-          # @param effective_date [Time, nil] An ISO 8601 format date that denotes when this credit balance should become avai
-          #
-          # @param expiry_date [Time, nil] An ISO 8601 format date that identifies the origination credit block to expire
-          #
-          # @param filters [Array<Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::Filter>, nil] Optional filter to specify which items this credit block applies to. If not spec
-          #
-          # @param invoice_settings [Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::InvoiceSettings, nil] Passing `invoice_settings` automatically generates an invoice for the newly adde
-          #
-          # @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
-          #
-          # @param per_unit_cost_basis [String, nil] Can only be specified when entry_type=increment. How much, in the customer's cur
-          #
-          # @param void_reason [Symbol, Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::VoidReason, nil] Can only be specified when `entry_type=void`. The reason for the void.
-          #
+          # @param body [Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::Body::Increment, Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::Body::Decrement, Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::Body::ExpirationChange, Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::Body::Void, Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::Body::Amendment]
           # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Orb::Models::Customers::Credits::IncrementLedgerEntry, Orb::Models::Customers::Credits::DecrementLedgerEntry, Orb::Models::Customers::Credits::ExpirationChangeLedgerEntry, Orb::Models::Customers::Credits::CreditBlockExpiryLedgerEntry, Orb::Models::Customers::Credits::VoidLedgerEntry, Orb::Models::Customers::Credits::VoidInitiatedLedgerEntry, Orb::Models::Customers::Credits::AmendmentLedgerEntry]
@@ -462,7 +407,7 @@ module Orb
             @client.request(
               method: :post,
               path: ["customers/external_customer_id/%1$s/credits/ledger_entry", external_customer_id],
-              body: parsed,
+              body: parsed[:body],
               model: Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDResponse,
               options: options
             )

data/lib/orb/resources/customers.rb

@@ -147,9 +147,10 @@ module Orb
       #
       # This endpoint can be used to update the `payment_provider`,
       # `payment_provider_id`, `name`, `email`, `email_delivery`, `tax_id`,
-      # `auto_collection`, `metadata`, `shipping_address`, `billing_address`, and
-      # `additional_emails` of an existing customer. Other fields on a customer are
-      # currently immutable.
+      # `auto_collection`, `metadata`, `shipping_address`, `billing_address`,
+      # `additional_emails`, and `currency` of an existing customer. `currency` can only
+      # be set if it has not already been set on the customer. Other fields on a
+      # customer are currently immutable.
       #
       # @overload update(customer_id, accounting_sync_configuration: nil, additional_emails: nil, auto_collection: nil, auto_issuance: nil, billing_address: nil, currency: nil, email: nil, email_delivery: nil, external_customer_id: nil, hierarchy: nil, metadata: nil, name: nil, payment_configuration: nil, payment_provider: nil, payment_provider_id: nil, reporting_configuration: nil, shipping_address: nil, tax_configuration: nil, tax_id: nil, request_options: {})
       #
@@ -165,7 +166,7 @@ module Orb
       #
       # @param billing_address [Orb::Models::AddressInput, nil]
       #
-      # @param currency [String, nil] An ISO 4217 currency string used for the customer's invoices and balance. If not
+      # @param currency [String, nil] An ISO 4217 currency string used for the customer's invoices and balance. This c
       #
       # @param email [String, nil] A valid customer email, to be used for invoicing and notifications.
       #
@@ -406,7 +407,7 @@ module Orb
       #
       # @param billing_address [Orb::Models::AddressInput, nil]
       #
-      # @param currency [String, nil] An ISO 4217 currency string used for the customer's invoices and balance. If not
+      # @param currency [String, nil] An ISO 4217 currency string used for the customer's invoices and balance. This c
       #
       # @param email [String, nil] A valid customer email, to be used for invoicing and notifications.
       #

data/lib/orb/resources/events/backfills.rb

@@ -15,8 +15,8 @@ module Orb
         # 3 steps:
         #
         # 1. Create the backfill, specifying its parameters.
-        # 2. [Ingest](ingest) usage events, referencing the backfill (query parameter
-        #    `backfill_id`).
+        # 2. [Ingest](/api-reference/event/ingest-events) usage events, referencing the
+        #    backfill (query parameter `backfill_id`).
         # 3. [Close](close-backfill) the backfill, propagating the update in past usage
         #    throughout Orb.
         #
@@ -91,8 +91,7 @@ module Orb
         # The list of backfills is ordered starting from the most recently created
         # backfill. The response also includes
         # [`pagination_metadata`](/api-reference/pagination), which lets the caller
-        # retrieve the next page of results if they exist. More information about
-        # pagination can be found in the [Pagination-metadata schema](pagination).
+        # retrieve the next page of results if they exist.
         #
         # @overload list(cursor: nil, limit: nil, request_options: {})
         #

data/lib/orb/resources/invoices.rb

@@ -431,23 +431,30 @@ module Orb
         )
       end
 
-      # This endpoint collects payment for an invoice using the customer's default
-      # payment method. This action can only be taken on invoices with status "issued".
+      # This endpoint collects payment for an invoice. By default, it uses the
+      # customer's default payment method. Optionally, a shared payment token (SPT) can
+      # be provided to pay using agent-granted credentials instead. This action can only
+      # be taken on invoices with status "issued".
       #
-      # @overload pay(invoice_id, request_options: {})
+      # @overload pay(invoice_id, shared_payment_token_id:, request_options: {})
       #
       # @param invoice_id [String]
+      #
+      # @param shared_payment_token_id [String] The ID of a shared payment token granted by an agent to use for this payment.
+      #
       # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Orb::Models::Invoice]
       #
       # @see Orb::Models::InvoicePayParams
-      def pay(invoice_id, params = {})
+      def pay(invoice_id, params)
+        parsed, options = Orb::InvoicePayParams.dump_request(params)
         @client.request(
           method: :post,
           path: ["invoices/%1$s/pay", invoice_id],
+          body: parsed,
           model: Orb::Invoice,
-          options: params[:request_options]
+          options: options
         )
       end
 

data/lib/orb/resources/prices.rb

@@ -26,9 +26,6 @@ module Orb
       # @return [Orb::Resources::Prices::ExternalPriceID]
       attr_reader :external_price_id
 
-      # Some parameter documentations has been truncated, see
-      # {Orb::Models::PriceCreateParams} for more details.
-      #
       # This endpoint is used to create a [price](/product-catalog/price-configuration).
       # A price created using this endpoint is always an add-on, meaning that it's not
       # associated with a specific plan and can instead be individually added to
@@ -40,103 +37,9 @@ module Orb
       # See the [Price resource](/product-catalog/price-configuration) for the
       # specification of different price model configurations possible in this endpoint.
       #
-      # @overload create(cadence:, currency:, item_id:, model_type:, name:, unit_config:, tiered_config:, bulk_config:, bulk_with_filters_config:, package_config:, matrix_config:, threshold_total_amount_config:, tiered_package_config:, tiered_with_minimum_config:, grouped_tiered_config:, tiered_package_with_minimum_config:, package_with_allocation_config:, unit_with_percent_config:, matrix_with_allocation_config:, tiered_with_proration_config:, unit_with_proration_config:, grouped_allocation_config:, bulk_with_proration_config:, grouped_with_prorated_minimum_config:, grouped_with_metered_minimum_config:, grouped_with_min_max_thresholds_config:, matrix_with_display_name_config:, grouped_tiered_package_config:, max_group_tiered_package_config:, scalable_matrix_with_unit_pricing_config:, scalable_matrix_with_tiered_pricing_config:, cumulative_grouped_bulk_config:, cumulative_grouped_allocation_config:, minimum_composite_config:, percent_config:, event_output_config:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, request_options: {})
-      #
-      # @param cadence [Symbol, Orb::Models::PriceCreateParams::Cadence] The cadence to bill for this price on.
-      #
-      # @param currency [String] An ISO 4217 currency string for which this price is billed in.
-      #
-      # @param item_id [String] The id of the item the price will be associated with.
-      #
-      # @param model_type [Symbol, Orb::Models::PriceCreateParams::ModelType] The pricing model type
-      #
-      # @param name [String] The name of the price.
-      #
-      # @param unit_config [Orb::Models::UnitConfig] Configuration for unit pricing
-      #
-      # @param tiered_config [Orb::Models::TieredConfig] Configuration for tiered pricing
-      #
-      # @param bulk_config [Orb::Models::BulkConfig] Configuration for bulk pricing
-      #
-      # @param bulk_with_filters_config [Orb::Models::PriceCreateParams::BulkWithFiltersConfig] Configuration for bulk_with_filters pricing
-      #
-      # @param package_config [Orb::Models::PackageConfig] Configuration for package pricing
-      #
-      # @param matrix_config [Orb::Models::MatrixConfig] Configuration for matrix pricing
-      #
-      # @param threshold_total_amount_config [Orb::Models::PriceCreateParams::ThresholdTotalAmountConfig] Configuration for threshold_total_amount pricing
-      #
-      # @param tiered_package_config [Orb::Models::PriceCreateParams::TieredPackageConfig] Configuration for tiered_package pricing
-      #
-      # @param tiered_with_minimum_config [Orb::Models::PriceCreateParams::TieredWithMinimumConfig] Configuration for tiered_with_minimum pricing
-      #
-      # @param grouped_tiered_config [Orb::Models::PriceCreateParams::GroupedTieredConfig] Configuration for grouped_tiered pricing
-      #
-      # @param tiered_package_with_minimum_config [Orb::Models::PriceCreateParams::TieredPackageWithMinimumConfig] Configuration for tiered_package_with_minimum pricing
-      #
-      # @param package_with_allocation_config [Orb::Models::PriceCreateParams::PackageWithAllocationConfig] Configuration for package_with_allocation pricing
-      #
-      # @param unit_with_percent_config [Orb::Models::PriceCreateParams::UnitWithPercentConfig] Configuration for unit_with_percent pricing
-      #
-      # @param matrix_with_allocation_config [Orb::Models::MatrixWithAllocationConfig] Configuration for matrix_with_allocation pricing
-      #
-      # @param tiered_with_proration_config [Orb::Models::PriceCreateParams::TieredWithProrationConfig] Configuration for tiered_with_proration pricing
-      #
-      # @param unit_with_proration_config [Orb::Models::PriceCreateParams::UnitWithProrationConfig] Configuration for unit_with_proration pricing
-      #
-      # @param grouped_allocation_config [Orb::Models::PriceCreateParams::GroupedAllocationConfig] Configuration for grouped_allocation pricing
-      #
-      # @param bulk_with_proration_config [Orb::Models::PriceCreateParams::BulkWithProrationConfig] Configuration for bulk_with_proration pricing
-      #
-      # @param grouped_with_prorated_minimum_config [Orb::Models::PriceCreateParams::GroupedWithProratedMinimumConfig] Configuration for grouped_with_prorated_minimum pricing
-      #
-      # @param grouped_with_metered_minimum_config [Orb::Models::PriceCreateParams::GroupedWithMeteredMinimumConfig] Configuration for grouped_with_metered_minimum pricing
-      #
-      # @param grouped_with_min_max_thresholds_config [Orb::Models::PriceCreateParams::GroupedWithMinMaxThresholdsConfig] Configuration for grouped_with_min_max_thresholds pricing
+      # @overload create(body:, request_options: {})
       #
-      # @param matrix_with_display_name_config [Orb::Models::PriceCreateParams::MatrixWithDisplayNameConfig] Configuration for matrix_with_display_name pricing
-      #
-      # @param grouped_tiered_package_config [Orb::Models::PriceCreateParams::GroupedTieredPackageConfig] Configuration for grouped_tiered_package pricing
-      #
-      # @param max_group_tiered_package_config [Orb::Models::PriceCreateParams::MaxGroupTieredPackageConfig] Configuration for max_group_tiered_package pricing
-      #
-      # @param scalable_matrix_with_unit_pricing_config [Orb::Models::PriceCreateParams::ScalableMatrixWithUnitPricingConfig] Configuration for scalable_matrix_with_unit_pricing pricing
-      #
-      # @param scalable_matrix_with_tiered_pricing_config [Orb::Models::PriceCreateParams::ScalableMatrixWithTieredPricingConfig] Configuration for scalable_matrix_with_tiered_pricing pricing
-      #
-      # @param cumulative_grouped_bulk_config [Orb::Models::PriceCreateParams::CumulativeGroupedBulkConfig] Configuration for cumulative_grouped_bulk pricing
-      #
-      # @param cumulative_grouped_allocation_config [Orb::Models::PriceCreateParams::CumulativeGroupedAllocationConfig] Configuration for cumulative_grouped_allocation pricing
-      #
-      # @param minimum_composite_config [Orb::Models::PriceCreateParams::MinimumCompositeConfig] Configuration for minimum_composite pricing
-      #
-      # @param percent_config [Orb::Models::PriceCreateParams::PercentConfig] Configuration for percent pricing
-      #
-      # @param event_output_config [Orb::Models::PriceCreateParams::EventOutputConfig] Configuration for event_output pricing
-      #
-      # @param billable_metric_id [String, nil] The id of the billable metric for the price. Only needed if the price is usage-b
-      #
-      # @param billed_in_advance [Boolean, nil] If the Price represents a fixed cost, the price will be billed in-advance if thi
-      #
-      # @param billing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] For custom cadence: specifies the duration of the billing period in days or mont
-      #
-      # @param conversion_rate [Float, nil] The per unit conversion rate of the price currency to the invoicing currency.
-      #
-      # @param conversion_rate_config [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil] The configuration for the rate of the price currency to the invoicing currency.
-      #
-      # @param dimensional_price_configuration [Orb::Models::NewDimensionalPriceConfiguration, nil] For dimensional price: specifies a price group and dimension values
-      #
-      # @param external_price_id [String, nil] An alias for the price.
-      #
-      # @param fixed_price_quantity [Float, nil] If the Price represents a fixed cost, this represents the quantity of units appl
-      #
-      # @param invoice_grouping_key [String, nil] The property used to group this price on an invoice
-      #
-      # @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
-      #
-      # @param license_type_id [String, nil] The ID of the license type to associate with this price.
-      #
-      # @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
+      # @param body [Orb::Models::NewFloatingUnitPrice, Orb::Models::NewFloatingTieredPrice, Orb::Models::NewFloatingBulkPrice, Orb::Models::PriceCreateParams::Body::BulkWithFilters, Orb::Models::NewFloatingPackagePrice, Orb::Models::NewFloatingMatrixPrice, Orb::Models::NewFloatingThresholdTotalAmountPrice, Orb::Models::NewFloatingTieredPackagePrice, Orb::Models::NewFloatingTieredWithMinimumPrice, Orb::Models::NewFloatingGroupedTieredPrice, Orb::Models::NewFloatingTieredPackageWithMinimumPrice, Orb::Models::NewFloatingPackageWithAllocationPrice, Orb::Models::NewFloatingUnitWithPercentPrice, Orb::Models::NewFloatingMatrixWithAllocationPrice, Orb::Models::NewFloatingTieredWithProrationPrice, Orb::Models::NewFloatingUnitWithProrationPrice, Orb::Models::NewFloatingGroupedAllocationPrice, Orb::Models::NewFloatingBulkWithProrationPrice, Orb::Models::NewFloatingGroupedWithProratedMinimumPrice, Orb::Models::NewFloatingGroupedWithMeteredMinimumPrice, Orb::Models::PriceCreateParams::Body::GroupedWithMinMaxThresholds, Orb::Models::NewFloatingMatrixWithDisplayNamePrice, Orb::Models::NewFloatingGroupedTieredPackagePrice, Orb::Models::NewFloatingMaxGroupTieredPackagePrice, Orb::Models::NewFloatingScalableMatrixWithUnitPricingPrice, Orb::Models::NewFloatingScalableMatrixWithTieredPricingPrice, Orb::Models::NewFloatingCumulativeGroupedBulkPrice, Orb::Models::PriceCreateParams::Body::CumulativeGroupedAllocation, Orb::Models::NewFloatingMinimumCompositePrice, Orb::Models::PriceCreateParams::Body::Percent, Orb::Models::PriceCreateParams::Body::EventOutput] New floating price request body params.
       #
       # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -145,7 +48,13 @@ module Orb
       # @see Orb::Models::PriceCreateParams
       def create(params)
         parsed, options = Orb::PriceCreateParams.dump_request(params)
-        @client.request(method: :post, path: "prices", body: parsed, model: Orb::Price, options: options)
+        @client.request(
+          method: :post,
+          path: "prices",
+          body: parsed[:body],
+          model: Orb::Price,
+          options: options
+        )
       end
 
       # Some parameter documentations has been truncated, see

data/lib/orb/resources/subscriptions.rb

@@ -568,10 +568,10 @@ module Orb
       # metric, in usage units rather than a currency).
       #
       # The semantics of this endpoint exactly mirror those of
-      # [fetching a customer's costs](fetch-customer-costs). Use this endpoint to limit
-      # your analysis of costs to a specific subscription for the customer (e.g. to
-      # de-aggregate costs when a customer's subscription has started and stopped on the
-      # same day).
+      # [fetching a customer's costs](/api-reference/customer/fetch-customer-costs). Use
+      # this endpoint to limit your analysis of costs to a specific subscription for the
+      # customer (e.g. to de-aggregate costs when a customer's subscription has started
+      # and stopped on the same day).
       #
       # @overload fetch_costs(subscription_id, currency: nil, timeframe_end: nil, timeframe_start: nil, view_mode: nil, request_options: {})
       #

data/lib/orb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Orb
-  VERSION = "1.13.0"
+  VERSION = "1.14.0"
 end

data/rbi/orb/client.rbi

@@ -13,6 +13,9 @@ module Orb
     sig { returns(String) }
     attr_reader :api_key
 
+    sig { returns(T.nilable(String)) }
+    attr_reader :webhook_secret
+
     sig { returns(Orb::Resources::TopLevel) }
     attr_reader :top_level
 
@@ -151,6 +154,7 @@ module Orb
     sig do
       params(
         api_key: T.nilable(String),
+        webhook_secret: T.nilable(String),
         base_url: T.nilable(String),
         max_retries: Integer,
         timeout: Float,
@@ -162,6 +166,8 @@ module Orb
     def self.new(
       # Defaults to `ENV["ORB_API_KEY"]`
       api_key: ENV["ORB_API_KEY"],
+      # Defaults to `ENV["ORB_WEBHOOK_SECRET"]`
+      webhook_secret: ENV["ORB_WEBHOOK_SECRET"],
       # Override the default base URL for the API, e.g.,
       # `"https://api.example.com/v2/"`. Defaults to `ENV["ORB_BASE_URL"]`
       base_url: ENV["ORB_BASE_URL"],

data/rbi/orb/internal/util.rbi

@@ -144,12 +144,20 @@ module Orb
         end
       end
 
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = T.let(/[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/, Regexp)
+
       class << self
         # @api private
         sig { params(uri: URI::Generic).returns(String) }
         def uri_origin(uri)
         end
 
+        # @api private
+        sig { params(path: T.any(String, Integer)).returns(String) }
+        def encode_path(path)
+        end
+
         # @api private
         sig { params(path: T.any(String, T::Array[String])).returns(String) }
         def interpolate_path(path)

data/rbi/orb/models/alert.rbi

@@ -65,6 +65,11 @@ module Orb
       sig { returns(T.nilable(T::Array[Orb::Alert::BalanceAlertStatus])) }
       attr_accessor :balance_alert_status
 
+      # The property keys to group cost alerts by. Only present for cost alerts with
+      # grouping enabled.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :grouping_keys
+
       # Minified license type for alert serialization.
       sig { returns(T.nilable(Orb::Alert::LicenseType)) }
       attr_reader :license_type
@@ -93,6 +98,7 @@ module Orb
           type: Orb::Alert::Type::OrSymbol,
           balance_alert_status:
             T.nilable(T::Array[Orb::Alert::BalanceAlertStatus::OrHash]),
+          grouping_keys: T.nilable(T::Array[String]),
           license_type: T.nilable(Orb::Alert::LicenseType::OrHash)
         ).returns(T.attached_class)
       end
@@ -121,6 +127,9 @@ module Orb
         # The current status of the alert. This field is only present for credit balance
         # alerts.
         balance_alert_status: nil,
+        # The property keys to group cost alerts by. Only present for cost alerts with
+        # grouping enabled.
+        grouping_keys: nil,
         # Minified license type for alert serialization.
         license_type: nil
       )
@@ -141,6 +150,7 @@ module Orb
             type: Orb::Alert::Type::TaggedSymbol,
             balance_alert_status:
               T.nilable(T::Array[Orb::Alert::BalanceAlertStatus]),
+            grouping_keys: T.nilable(T::Array[String]),
             license_type: T.nilable(Orb::Alert::LicenseType)
           }
         )

data/rbi/orb/models/alert_create_for_customer_params.rbi

@@ -11,6 +11,9 @@ module Orb
           T.any(Orb::AlertCreateForCustomerParams, Orb::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :customer_id
+
       # The case sensitive currency or custom pricing unit to use for this alert.
       sig { returns(String) }
       attr_accessor :currency
@@ -25,6 +28,7 @@ module Orb
 
       sig do
         params(
+          customer_id: String,
           currency: String,
           type: Orb::AlertCreateForCustomerParams::Type::OrSymbol,
           thresholds: T.nilable(T::Array[Orb::Threshold::OrHash]),
@@ -32,6 +36,7 @@ module Orb
         ).returns(T.attached_class)
       end
       def self.new(
+        customer_id:,
         # The case sensitive currency or custom pricing unit to use for this alert.
         currency:,
         # The type of alert to create. This must be a valid alert type.
@@ -45,6 +50,7 @@ module Orb
       sig do
         override.returns(
           {
+            customer_id: String,
             currency: String,
             type: Orb::AlertCreateForCustomerParams::Type::OrSymbol,
             thresholds: T.nilable(T::Array[Orb::Threshold]),

data/rbi/orb/models/alert_create_for_external_customer_params.rbi

@@ -14,6 +14,9 @@ module Orb
           )
         end
 
+      sig { returns(String) }
+      attr_accessor :external_customer_id
+
       # The case sensitive currency or custom pricing unit to use for this alert.
       sig { returns(String) }
       attr_accessor :currency
@@ -28,6 +31,7 @@ module Orb
 
       sig do
         params(
+          external_customer_id: String,
           currency: String,
           type: Orb::AlertCreateForExternalCustomerParams::Type::OrSymbol,
           thresholds: T.nilable(T::Array[Orb::Threshold::OrHash]),
@@ -35,6 +39,7 @@ module Orb
         ).returns(T.attached_class)
       end
       def self.new(
+        external_customer_id:,
         # The case sensitive currency or custom pricing unit to use for this alert.
         currency:,
         # The type of alert to create. This must be a valid alert type.
@@ -48,6 +53,7 @@ module Orb
       sig do
         override.returns(
           {
+            external_customer_id: String,
             currency: String,
             type: Orb::AlertCreateForExternalCustomerParams::Type::OrSymbol,
             thresholds: T.nilable(T::Array[Orb::Threshold]),

data/rbi/orb/models/alert_create_for_subscription_params.rbi

@@ -11,6 +11,9 @@ module Orb
           T.any(Orb::AlertCreateForSubscriptionParams, Orb::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :subscription_id
+
       # The thresholds that define the values at which the alert will be triggered.
       sig { returns(T::Array[Orb::Threshold]) }
       attr_accessor :thresholds
@@ -19,25 +22,45 @@ module Orb
       sig { returns(Orb::AlertCreateForSubscriptionParams::Type::OrSymbol) }
       attr_accessor :type
 
+      # The property keys to group cost alerts by. Only applicable for cost_exceeded
+      # alerts.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :grouping_keys
+
       # The metric to track usage for.
       sig { returns(T.nilable(String)) }
       attr_accessor :metric_id
 
+      # The pricing unit to use for grouped cost alerts. Required when grouping_keys is
+      # set.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :pricing_unit_id
+
       sig do
         params(
+          subscription_id: String,
           thresholds: T::Array[Orb::Threshold::OrHash],
           type: Orb::AlertCreateForSubscriptionParams::Type::OrSymbol,
+          grouping_keys: T.nilable(T::Array[String]),
           metric_id: T.nilable(String),
+          pricing_unit_id: T.nilable(String),
           request_options: Orb::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        subscription_id:,
         # The thresholds that define the values at which the alert will be triggered.
         thresholds:,
         # The type of alert to create. This must be a valid alert type.
         type:,
+        # The property keys to group cost alerts by. Only applicable for cost_exceeded
+        # alerts.
+        grouping_keys: nil,
         # The metric to track usage for.
         metric_id: nil,
+        # The pricing unit to use for grouped cost alerts. Required when grouping_keys is
+        # set.
+        pricing_unit_id: nil,
         request_options: {}
       )
       end
@@ -45,9 +68,12 @@ module Orb
       sig do
         override.returns(
           {
+            subscription_id: String,
             thresholds: T::Array[Orb::Threshold],
             type: Orb::AlertCreateForSubscriptionParams::Type::OrSymbol,
+            grouping_keys: T.nilable(T::Array[String]),
             metric_id: T.nilable(String),
+            pricing_unit_id: T.nilable(String),
             request_options: Orb::RequestOptions
           }
         )

data/rbi/orb/models/alert_disable_params.rbi

@@ -9,17 +9,22 @@ module Orb
       OrHash =
         T.type_alias { T.any(Orb::AlertDisableParams, Orb::Internal::AnyHash) }
 
+      sig { returns(String) }
+      attr_accessor :alert_configuration_id
+
       # Used to update the status of a plan alert scoped to this subscription_id
       sig { returns(T.nilable(String)) }
       attr_accessor :subscription_id
 
       sig do
         params(
+          alert_configuration_id: String,
           subscription_id: T.nilable(String),
           request_options: Orb::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        alert_configuration_id:,
         # Used to update the status of a plan alert scoped to this subscription_id
         subscription_id: nil,
         request_options: {}
@@ -29,6 +34,7 @@ module Orb
       sig do
         override.returns(
           {
+            alert_configuration_id: String,
             subscription_id: T.nilable(String),
             request_options: Orb::RequestOptions
           }