orb-billing 1.14.0 → 1.16.0

data/rbi/orb/models/subscription_update_params.rbi

@@ -20,6 +20,13 @@ module Orb
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :auto_collection
 
+      # Used to determine if invoices for this subscription will be automatically
+      # issued. If true, invoices will be automatically issued. If false, invoices will
+      # require manual approval. If `null` is specified, this defaults to the behavior
+      # configured for this customer.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_accessor :auto_issuance
+
       # Determines the default memo on this subscription's invoices. Note that if this
       # is not provided, it is determined by the plan configuration.
       sig { returns(T.nilable(String)) }
@@ -48,6 +55,7 @@ module Orb
         params(
           subscription_id: String,
           auto_collection: T.nilable(T::Boolean),
+          auto_issuance: T.nilable(T::Boolean),
           default_invoice_memo: T.nilable(String),
           invoicing_threshold: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
@@ -61,6 +69,11 @@ module Orb
         # charged with the saved payment method on the due date. This property defaults to
         # the plan's behavior.
         auto_collection: nil,
+        # Used to determine if invoices for this subscription will be automatically
+        # issued. If true, invoices will be automatically issued. If false, invoices will
+        # require manual approval. If `null` is specified, this defaults to the behavior
+        # configured for this customer.
+        auto_issuance: nil,
         # Determines the default memo on this subscription's invoices. Note that if this
         # is not provided, it is determined by the plan configuration.
         default_invoice_memo: nil,
@@ -86,6 +99,7 @@ module Orb
           {
             subscription_id: String,
             auto_collection: T.nilable(T::Boolean),
+            auto_issuance: T.nilable(T::Boolean),
             default_invoice_memo: T.nilable(String),
             invoicing_threshold: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),

data/rbi/orb/models.rbi

@@ -61,6 +61,8 @@ module Orb
 
   ChangedSubscriptionResources = Orb::Models::ChangedSubscriptionResources
 
+  ConversionRateConfig = Orb::Models::ConversionRateConfig
+
   ConversionRateTier = Orb::Models::ConversionRateTier
 
   ConversionRateTieredConfig = Orb::Models::ConversionRateTieredConfig

data/rbi/orb/resources/alerts.rbi

@@ -23,6 +23,12 @@ module Orb
         params(
           alert_configuration_id: String,
           thresholds: T::Array[Orb::Threshold::OrHash],
+          price_filters:
+            T.nilable(T::Array[Orb::AlertUpdateParams::PriceFilter::OrHash]),
+          threshold_overrides:
+            T.nilable(
+              T::Array[Orb::AlertUpdateParams::ThresholdOverride::OrHash]
+            ),
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Alert)
       end
@@ -30,6 +36,13 @@ module Orb
         alert_configuration_id,
         # The thresholds that define the values at which the alert will be triggered.
         thresholds:,
+        # Replaces the price filters on a grouped cost alert; an empty list clears them.
+        # Only applicable to cost alerts with grouping_keys. Omit to leave unchanged.
+        price_filters: nil,
+        # Replaces the per-group threshold overrides on a grouped cost alert; an empty
+        # list clears them. Only applicable to cost alerts with grouping_keys. Omit to
+        # leave unchanged.
+        threshold_overrides: nil,
         request_options: {}
       )
       end
@@ -153,9 +166,21 @@ module Orb
           subscription_id: String,
           thresholds: T::Array[Orb::Threshold::OrHash],
           type: Orb::AlertCreateForSubscriptionParams::Type::OrSymbol,
+          currency: T.nilable(String),
           grouping_keys: T.nilable(T::Array[String]),
           metric_id: T.nilable(String),
-          pricing_unit_id: T.nilable(String),
+          price_filters:
+            T.nilable(
+              T::Array[
+                Orb::AlertCreateForSubscriptionParams::PriceFilter::OrHash
+              ]
+            ),
+          threshold_overrides:
+            T.nilable(
+              T::Array[
+                Orb::AlertCreateForSubscriptionParams::ThresholdOverride::OrHash
+              ]
+            ),
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Alert)
       end
@@ -165,14 +190,24 @@ module Orb
         thresholds:,
         # The type of alert to create. This must be a valid alert type.
         type:,
+        # The case sensitive currency or custom pricing unit to use for grouped cost
+        # alerts. Required when grouping_keys is set.
+        currency: nil,
         # 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,
+        # Filters to scope which prices are included in grouped cost alert evaluation.
+        # Supports filtering by price_id, item_id, or price_type with includes/excludes
+        # operators. Only applicable when grouping_keys is set.
+        price_filters: nil,
+        # Per-group threshold overrides. Each override maps a specific combination of
+        # grouping_keys values to a list of thresholds that fully replaces the default
+        # thresholds for that group. An empty thresholds list silences the group. Groups
+        # without an override use the default thresholds. Only applicable when
+        # grouping_keys is set.
+        threshold_overrides: nil,
         request_options: {}
       )
       end

data/rbi/orb/resources/customers/credits/ledger.rbi

@@ -172,8 +172,9 @@ module Orb
           # }
           # ```
           #
-          # Note that by default, Orb will always first increment any _negative_ balance in
-          # existing blocks before adding the remaining amount to the desired credit block.
+          # Note that an `increment` entry always creates a new credit block (defined by the
+          # optional `effective_date` and `expiry_date`); it never modifies an existing
+          # block.
           #
           # ### Invoicing for credits
           #
@@ -194,11 +195,17 @@ module Orb
           # ## Deducting Credits
           #
           # Orb allows you to deduct credits from a customer by creating an entry of type
-          # `decrement`. Orb matches the algorithm for automatic deductions for determining
-          # which credit blocks to decrement from. In the case that the deduction leads to
-          # multiple ledger entries, the response from this endpoint will be the final
-          # deduction. Orb also optionally allows specifying a description to assist with
-          # auditing.
+          # `decrement`. A `decrement` entry records credits as usage and immediately
+          # recognizes revenue at the block's `per_unit_cost_basis`.
+          #
+          # For most credit removals, use `void` (no revenue impact) or `expiration_change`
+          # (revenue recognized on expiration) instead. Only use `decrement` when credits
+          # were genuinely consumed outside of normal event ingestion.
+          #
+          # Orb matches the algorithm for automatic deductions for determining which credit
+          # blocks to decrement from. In the case that the deduction leads to multiple
+          # ledger entries, the response from this endpoint will be the final deduction. Orb
+          # also optionally allows specifying a description to assist with auditing.
           #
           # The following snippet illustrates a sample request body to decrement credits.
           #
@@ -308,8 +315,9 @@ module Orb
           # }
           # ```
           #
-          # Note that by default, Orb will always first increment any _negative_ balance in
-          # existing blocks before adding the remaining amount to the desired credit block.
+          # Note that an `increment` entry always creates a new credit block (defined by the
+          # optional `effective_date` and `expiry_date`); it never modifies an existing
+          # block.
           #
           # ### Invoicing for credits
           #
@@ -330,11 +338,17 @@ module Orb
           # ## Deducting Credits
           #
           # Orb allows you to deduct credits from a customer by creating an entry of type
-          # `decrement`. Orb matches the algorithm for automatic deductions for determining
-          # which credit blocks to decrement from. In the case that the deduction leads to
-          # multiple ledger entries, the response from this endpoint will be the final
-          # deduction. Orb also optionally allows specifying a description to assist with
-          # auditing.
+          # `decrement`. A `decrement` entry records credits as usage and immediately
+          # recognizes revenue at the block's `per_unit_cost_basis`.
+          #
+          # For most credit removals, use `void` (no revenue impact) or `expiration_change`
+          # (revenue recognized on expiration) instead. Only use `decrement` when credits
+          # were genuinely consumed outside of normal event ingestion.
+          #
+          # Orb matches the algorithm for automatic deductions for determining which credit
+          # blocks to decrement from. In the case that the deduction leads to multiple
+          # ledger entries, the response from this endpoint will be the final deduction. Orb
+          # also optionally allows specifying a description to assist with auditing.
           #
           # The following snippet illustrates a sample request body to decrement credits.
           #

data/rbi/orb/resources/customers.rbi

@@ -225,11 +225,13 @@ module Orb
         # | Estonia                | `eu_vat`     | European VAT Number                                                                                     |
         # | Ethiopia               | `et_tin`     | Ethiopia Tax Identification Number                                                                      |
         # | European Union         | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+        # | Faroe Islands          | `fo_vat`     | Faroe Islands VAT Number                                                                                |
         # | Finland                | `eu_vat`     | European VAT Number                                                                                     |
         # | France                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Georgia                | `ge_vat`     | Georgian VAT                                                                                            |
         # | Germany                | `de_stn`     | German Tax Number (Steuernummer)                                                                        |
         # | Germany                | `eu_vat`     | European VAT Number                                                                                     |
+        # | Gibraltar              | `gi_tin`     | Gibraltar Tax Identification Number                                                                     |
         # | Greece                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Guinea                 | `gn_nif`     | Guinea Tax Identification Number (Número de Identificação Fiscal)                                       |
         # | Hong Kong              | `hk_br`      | Hong Kong BR Number                                                                                     |
@@ -241,6 +243,7 @@ module Orb
         # | Ireland                | `eu_vat`     | European VAT Number                                                                                     |
         # | Israel                 | `il_vat`     | Israel VAT                                                                                              |
         # | Italy                  | `eu_vat`     | European VAT Number                                                                                     |
+        # | Italy                  | `it_cf`      | Italian Codice Fiscale Number                                                                           |
         # | Japan                  | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
         # | Japan                  | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
         # | Japan                  | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
@@ -271,6 +274,7 @@ module Orb
         # | Norway                 | `no_vat`     | Norwegian VAT Number                                                                                    |
         # | Norway                 | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
         # | Oman                   | `om_vat`     | Omani VAT Number                                                                                        |
+        # | Paraguay               | `py_ruc`     | Paraguayan RUC Number                                                                                   |
         # | Peru                   | `pe_ruc`     | Peruvian RUC Number                                                                                     |
         # | Philippines            | `ph_tin`     | Philippines Tax Identification Number                                                                   |
         # | Poland                 | `eu_vat`     | European VAT Number                                                                                     |
@@ -292,6 +296,7 @@ module Orb
         # | South Korea            | `kr_brn`     | Korean BRN                                                                                              |
         # | Spain                  | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
         # | Spain                  | `eu_vat`     | European VAT Number                                                                                     |
+        # | Sri Lanka              | `lk_vat`     | Sri Lanka VAT Number                                                                                    |
         # | Suriname               | `sr_fin`     | Suriname FIN Number                                                                                     |
         # | Sweden                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Switzerland            | `ch_uid`     | Switzerland UID Number                                                                                  |
@@ -338,6 +343,7 @@ module Orb
           auto_issuance: T.nilable(T::Boolean),
           billing_address: T.nilable(Orb::AddressInput::OrHash),
           currency: T.nilable(String),
+          default_payment_method_id: T.nilable(String),
           email: T.nilable(String),
           email_delivery: T.nilable(T::Boolean),
           external_customer_id: T.nilable(String),
@@ -389,6 +395,9 @@ module Orb
         # not set at creation or update time, it will be set at subscription creation
         # time.
         currency: nil,
+        # The Orb ID of the payment method to set as this customer's default. Pass `null`
+        # to clear the customer's default payment method.
+        default_payment_method_id: nil,
         # A valid customer email, to be used for invoicing and notifications.
         email: nil,
         email_delivery: nil,
@@ -480,11 +489,13 @@ module Orb
         # | Estonia                | `eu_vat`     | European VAT Number                                                                                     |
         # | Ethiopia               | `et_tin`     | Ethiopia Tax Identification Number                                                                      |
         # | European Union         | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+        # | Faroe Islands          | `fo_vat`     | Faroe Islands VAT Number                                                                                |
         # | Finland                | `eu_vat`     | European VAT Number                                                                                     |
         # | France                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Georgia                | `ge_vat`     | Georgian VAT                                                                                            |
         # | Germany                | `de_stn`     | German Tax Number (Steuernummer)                                                                        |
         # | Germany                | `eu_vat`     | European VAT Number                                                                                     |
+        # | Gibraltar              | `gi_tin`     | Gibraltar Tax Identification Number                                                                     |
         # | Greece                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Guinea                 | `gn_nif`     | Guinea Tax Identification Number (Número de Identificação Fiscal)                                       |
         # | Hong Kong              | `hk_br`      | Hong Kong BR Number                                                                                     |
@@ -496,6 +507,7 @@ module Orb
         # | Ireland                | `eu_vat`     | European VAT Number                                                                                     |
         # | Israel                 | `il_vat`     | Israel VAT                                                                                              |
         # | Italy                  | `eu_vat`     | European VAT Number                                                                                     |
+        # | Italy                  | `it_cf`      | Italian Codice Fiscale Number                                                                           |
         # | Japan                  | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
         # | Japan                  | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
         # | Japan                  | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
@@ -526,6 +538,7 @@ module Orb
         # | Norway                 | `no_vat`     | Norwegian VAT Number                                                                                    |
         # | Norway                 | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
         # | Oman                   | `om_vat`     | Omani VAT Number                                                                                        |
+        # | Paraguay               | `py_ruc`     | Paraguayan RUC Number                                                                                   |
         # | Peru                   | `pe_ruc`     | Peruvian RUC Number                                                                                     |
         # | Philippines            | `ph_tin`     | Philippines Tax Identification Number                                                                   |
         # | Poland                 | `eu_vat`     | European VAT Number                                                                                     |
@@ -547,6 +560,7 @@ module Orb
         # | South Korea            | `kr_brn`     | Korean BRN                                                                                              |
         # | Spain                  | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
         # | Spain                  | `eu_vat`     | European VAT Number                                                                                     |
+        # | Sri Lanka              | `lk_vat`     | Sri Lanka VAT Number                                                                                    |
         # | Suriname               | `sr_fin`     | Suriname FIN Number                                                                                     |
         # | Sweden                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Switzerland            | `ch_uid`     | Switzerland UID Number                                                                                  |
@@ -701,6 +715,7 @@ module Orb
           auto_issuance: T.nilable(T::Boolean),
           billing_address: T.nilable(Orb::AddressInput::OrHash),
           currency: T.nilable(String),
+          default_payment_method_id: T.nilable(String),
           email: T.nilable(String),
           email_delivery: T.nilable(T::Boolean),
           external_customer_id: T.nilable(String),
@@ -756,6 +771,9 @@ module Orb
         # not set at creation or update time, it will be set at subscription creation
         # time.
         currency: nil,
+        # The Orb ID of the payment method to set as this customer's default. Pass `null`
+        # to clear the customer's default payment method.
+        default_payment_method_id: nil,
         # A valid customer email, to be used for invoicing and notifications.
         email: nil,
         email_delivery: nil,
@@ -847,11 +865,13 @@ module Orb
         # | Estonia                | `eu_vat`     | European VAT Number                                                                                     |
         # | Ethiopia               | `et_tin`     | Ethiopia Tax Identification Number                                                                      |
         # | European Union         | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+        # | Faroe Islands          | `fo_vat`     | Faroe Islands VAT Number                                                                                |
         # | Finland                | `eu_vat`     | European VAT Number                                                                                     |
         # | France                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Georgia                | `ge_vat`     | Georgian VAT                                                                                            |
         # | Germany                | `de_stn`     | German Tax Number (Steuernummer)                                                                        |
         # | Germany                | `eu_vat`     | European VAT Number                                                                                     |
+        # | Gibraltar              | `gi_tin`     | Gibraltar Tax Identification Number                                                                     |
         # | Greece                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Guinea                 | `gn_nif`     | Guinea Tax Identification Number (Número de Identificação Fiscal)                                       |
         # | Hong Kong              | `hk_br`      | Hong Kong BR Number                                                                                     |
@@ -863,6 +883,7 @@ module Orb
         # | Ireland                | `eu_vat`     | European VAT Number                                                                                     |
         # | Israel                 | `il_vat`     | Israel VAT                                                                                              |
         # | Italy                  | `eu_vat`     | European VAT Number                                                                                     |
+        # | Italy                  | `it_cf`      | Italian Codice Fiscale Number                                                                           |
         # | Japan                  | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
         # | Japan                  | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
         # | Japan                  | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
@@ -893,6 +914,7 @@ module Orb
         # | Norway                 | `no_vat`     | Norwegian VAT Number                                                                                    |
         # | Norway                 | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
         # | Oman                   | `om_vat`     | Omani VAT Number                                                                                        |
+        # | Paraguay               | `py_ruc`     | Paraguayan RUC Number                                                                                   |
         # | Peru                   | `pe_ruc`     | Peruvian RUC Number                                                                                     |
         # | Philippines            | `ph_tin`     | Philippines Tax Identification Number                                                                   |
         # | Poland                 | `eu_vat`     | European VAT Number                                                                                     |
@@ -914,6 +936,7 @@ module Orb
         # | South Korea            | `kr_brn`     | Korean BRN                                                                                              |
         # | Spain                  | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
         # | Spain                  | `eu_vat`     | European VAT Number                                                                                     |
+        # | Sri Lanka              | `lk_vat`     | Sri Lanka VAT Number                                                                                    |
         # | Suriname               | `sr_fin`     | Suriname FIN Number                                                                                     |
         # | Sweden                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Switzerland            | `ch_uid`     | Switzerland UID Number                                                                                  |

data/rbi/orb/resources/events.rbi

@@ -258,8 +258,8 @@ module Orb
       # billed for in the corresponding billing period.
       #
       # In general, Orb does not expect events with future dated timestamps. In cases
-      # where the timestamp is at least 24 hours ahead of the current time, the event
-      # will not be accepted as a valid event, and will throw validation errors.
+      # where the timestamp is 5 minutes ahead of the current time, the event will not
+      # be accepted as a valid event, and will throw validation errors.
       #
       # ## Event validation
       #
@@ -274,9 +274,9 @@ module Orb
       # - If the `external_customer_id` is specified, the customer in Orb does not need
       #   to exist. Events will be attributed to any future customers with the
       #   `external_customer_id` on subscription creation.
-      # - `timestamp` must conform to ISO 8601 and represent a timestamp at most 1 hour
-      #   in the future. This timestamp should be sent in UTC timezone (no timezone
-      #   offset).
+      # - `timestamp` must conform to ISO 8601 and represent a timestamp at most 5
+      #   minutes in the future. This timestamp should be sent in UTC timezone (no
+      #   timezone offset).
       #
       # ## Idempotency and retry semantics
       #
@@ -313,34 +313,7 @@ module Orb
       # request payload size, but please give us a heads up if you’re changing either of
       # these factors by an order of magnitude from initial setup.
       #
-      # ## Testing in debug mode
-      #
-      # The ingestion API supports a debug mode, which returns additional verbose output
-      # to indicate which event idempotency keys were newly ingested or duplicates from
-      # previous requests. To enable this mode, mark `debug=true` as a query parameter.
-      #
-      # If `debug=true` is not specified, the response will only contain
-      # `validation_failed`. Orb will still honor the idempotency guarantees set
-      # [here](/events-and-metrics/event-ingestion#event-volume-and-concurrency) in all
-      # cases.
-      #
-      # We strongly recommend that you only use debug mode as part of testing your
-      # initial Orb integration. Once you're ready to switch to production, disable
-      # debug mode to take advantage of improved performance and maximal throughput.
-      #
-      # #### Example: ingestion response with `debug=true`
-      #
-      # ```json
-      # {
-      #   "debug": {
-      #     "duplicate": [],
-      #     "ingested": ["B7E83HDMfJPAunXW", "SJs5DQJ3TnwSqEZE", "8SivfDsNKwCeAXim"]
-      #   },
-      #   "validation_failed": []
-      # }
-      # ```
-      #
-      # #### Example: ingestion response with `debug=false`
+      # #### Example: ingestion response
       #
       # ```json
       # {
@@ -361,8 +334,8 @@ module Orb
         # Query param: If this ingestion request is part of a backfill, this parameter
         # ties the ingested events to the backfill
         backfill_id: nil,
-        # Query param: Flag to enable additional debug information in the endpoint
-        # response
+        # Query param: Pending Deprecation: Flag to enable additional debug information in
+        # the endpoint response
         debug: nil,
         request_options: {}
       )

data/rbi/orb/resources/invoices.rbi

@@ -22,7 +22,8 @@ module Orb
                 Orb::PercentageDiscount::OrHash,
                 Orb::TrialDiscount::OrHash,
                 Orb::UsageDiscount::OrHash,
-                Orb::AmountDiscount::OrHash
+                Orb::AmountDiscount::OrHash,
+                Orb::Discount::TieredPercentage::OrHash
               )
             ),
           due_date: T.nilable(Orb::InvoiceCreateParams::DueDate::Variants),
@@ -38,8 +39,9 @@ module Orb
         # An ISO 4217 currency string. Must be the same as the customer's currency if it
         # is set.
         currency:,
-        # Optional invoice date to set. Must be in the past, if not set, `invoice_date` is
-        # set to the current time in the customer's timezone.
+        # An ISO 8601 date or timestamp, interpreted in the customer's timezone. Must be
+        # in the past. If a date is set without a time, `invoice_date` is set to midnight
+        # on the chosen date in the customer's timezone.
         invoice_date:,
         line_items:,
         # Determines whether this invoice will automatically attempt to charge a saved
@@ -136,6 +138,10 @@ module Orb
       # When fetching any `draft` invoices, this returns the last-computed invoice
       # values for each draft invoice, which may not always be up-to-date since Orb
       # regularly refreshes invoices asynchronously.
+      #
+      # If you don't need line item details, minimums, maximums, or discounts, prefer
+      # the [list invoices summary](/api-reference/invoice/list-invoices-summary)
+      # endpoint for better performance.
       sig do
         params(
           amount: T.nilable(String),

data/rbi/orb/resources/licenses/external_licenses.rbi

@@ -15,7 +15,7 @@ module Orb
             subscription_id: String,
             cursor: T.nilable(String),
             end_date: T.nilable(Date),
-            group_by: T.nilable(T::Array[String]),
+            group_by: T.nilable(String),
             limit: Integer,
             start_date: T.nilable(Date),
             request_options: Orb::RequestOptions::OrHash

data/rbi/orb/resources/licenses/usage.rbi

@@ -14,7 +14,7 @@ module Orb
             subscription_id: String,
             cursor: T.nilable(String),
             end_date: T.nilable(Date),
-            group_by: T.nilable(T::Array[String]),
+            group_by: T.nilable(String),
             limit: Integer,
             start_date: T.nilable(Date),
             request_options: Orb::RequestOptions::OrHash
@@ -50,7 +50,7 @@ module Orb
             license_id: String,
             cursor: T.nilable(String),
             end_date: T.nilable(Date),
-            group_by: T.nilable(T::Array[String]),
+            group_by: T.nilable(String),
             limit: Integer,
             start_date: T.nilable(Date),
             request_options: Orb::RequestOptions::OrHash

data/rbi/orb/resources/metrics.rbi

@@ -56,9 +56,8 @@ module Orb
       )
       end
 
-      # This endpoint is used to fetch [metric](/core-concepts##metric) details given a
-      # metric identifier. It returns information about the metrics including its name,
-      # description, and item.
+      # This endpoint is used to list [metrics](/core-concepts#metric). It returns
+      # information about the metrics including its name, description, and item.
       sig do
         params(
           created_at_gt: T.nilable(Time),
@@ -84,8 +83,9 @@ module Orb
       )
       end
 
-      # This endpoint is used to list [metrics](/core-concepts#metric). It returns
-      # information about the metrics including its name, description, and item.
+      # This endpoint is used to fetch [metric](/core-concepts#metric) details given a
+      # metric identifier. It returns information about the metrics including its name,
+      # description, and item.
       sig do
         params(
           metric_id: String,

data/rbi/orb/resources/plans/external_plan_id.rbi

@@ -8,13 +8,14 @@ module Orb
       # subscription. You can see more about how to configure prices in the
       # [Price resource](/reference/price).
       class ExternalPlanID
-        # This endpoint can be used to update the `external_plan_id`, and `metadata` of an
-        # existing plan.
+        # This endpoint can be used to update the `external_plan_id`, `description`, and
+        # `metadata` of an existing plan.
         #
         # Other fields on a plan are currently immutable.
         sig do
           params(
             other_external_plan_id: String,
+            description: T.nilable(String),
             external_plan_id: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
             request_options: Orb::RequestOptions::OrHash
@@ -22,6 +23,8 @@ module Orb
         end
         def update(
           other_external_plan_id,
+          # An optional user-defined description of the plan.
+          description: nil,
           # 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
           # identifier in your system.

data/rbi/orb/resources/plans.rbi

@@ -30,6 +30,7 @@ module Orb
           adjustments:
             T.nilable(T::Array[Orb::PlanCreateParams::Adjustment::OrHash]),
           default_invoice_memo: T.nilable(String),
+          description: T.nilable(String),
           external_plan_id: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
           net_terms: T.nilable(Integer),
@@ -52,6 +53,8 @@ module Orb
         adjustments: nil,
         # Free-form text which is available on the invoice PDF and the Orb invoice portal.
         default_invoice_memo: nil,
+        # An optional user-defined description of the plan.
+        description: 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
@@ -71,13 +74,14 @@ module Orb
       )
       end
 
-      # This endpoint can be used to update the `external_plan_id`, and `metadata` of an
-      # existing plan.
+      # This endpoint can be used to update the `external_plan_id`, `description`, and
+      # `metadata` of an existing plan.
       #
       # Other fields on a plan are currently immutable.
       sig do
         params(
           plan_id: String,
+          description: T.nilable(String),
           external_plan_id: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
           request_options: Orb::RequestOptions::OrHash
@@ -85,6 +89,8 @@ module Orb
       end
       def update(
         plan_id,
+        # An optional user-defined description of the plan.
+        description: nil,
         # 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
         # identifier in your system.
@@ -100,7 +106,7 @@ module Orb
       # This endpoint returns a list of all [plans](/core-concepts#plan-and-price) for
       # an account in a list format. The list of plans is ordered starting from the most
       # recently created plan. The response also includes
-      # [`pagination_metadata`](/api-reference/pagination), which lets the caller
+      # [`pagination_metadata`](/api-reference/pagination) which lets the caller
       # retrieve the next page of results if they exist.
       sig do
         params(

data/rbi/orb/resources/prices.rbi

@@ -54,6 +54,7 @@ module Orb
               Orb::NewFloatingPackageWithAllocationPrice::OrHash,
               Orb::NewFloatingUnitWithPercentPrice::OrHash,
               Orb::NewFloatingMatrixWithAllocationPrice::OrHash,
+              Orb::PriceCreateParams::Body::MatrixWithThresholdDiscounts::OrHash,
               Orb::NewFloatingTieredWithProrationPrice::OrHash,
               Orb::NewFloatingUnitWithProrationPrice::OrHash,
               Orb::NewFloatingGroupedAllocationPrice::OrHash,
@@ -68,6 +69,8 @@ module Orb
               Orb::NewFloatingScalableMatrixWithTieredPricingPrice::OrHash,
               Orb::NewFloatingCumulativeGroupedBulkPrice::OrHash,
               Orb::PriceCreateParams::Body::CumulativeGroupedAllocation::OrHash,
+              Orb::PriceCreateParams::Body::DailyCreditAllowance::OrHash,
+              Orb::PriceCreateParams::Body::MeteredAllowance::OrHash,
               Orb::NewFloatingMinimumCompositePrice::OrHash,
               Orb::PriceCreateParams::Body::Percent::OrHash,
               Orb::PriceCreateParams::Body::EventOutput::OrHash