orb-billing 1.13.0 → 1.15.0

data/rbi/orb/models/subscription_trigger_phase_params.rbi

@@ -11,6 +11,9 @@ module Orb
           T.any(Orb::SubscriptionTriggerPhaseParams, Orb::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :subscription_id
+
       # If false, this request will fail if it would void an issued invoice or create a
       # credit note. Consider using this as a safety mechanism if you do not expect
       # existing invoices to be changed.
@@ -24,12 +27,14 @@ module Orb
 
       sig do
         params(
+          subscription_id: String,
           allow_invoice_credit_or_void: T.nilable(T::Boolean),
           effective_date: T.nilable(Date),
           request_options: Orb::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        subscription_id:,
         # If false, this request will fail if it would void an issued invoice or create a
         # credit note. Consider using this as a safety mechanism if you do not expect
         # existing invoices to be changed.
@@ -44,6 +49,7 @@ module Orb
       sig do
         override.returns(
           {
+            subscription_id: String,
             allow_invoice_credit_or_void: T.nilable(T::Boolean),
             effective_date: T.nilable(Date),
             request_options: Orb::RequestOptions

data/rbi/orb/models/subscription_unschedule_cancellation_params.rbi

@@ -14,15 +14,23 @@ module Orb
           )
         end
 
+      sig { returns(String) }
+      attr_accessor :subscription_id
+
       sig do
-        params(request_options: Orb::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          subscription_id: String,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(subscription_id:, request_options: {})
       end
 
-      sig { override.returns({ request_options: Orb::RequestOptions }) }
+      sig do
+        override.returns(
+          { subscription_id: String, request_options: Orb::RequestOptions }
+        )
+      end
       def to_hash
       end
     end

data/rbi/orb/models/subscription_unschedule_fixed_fee_quantity_updates_params.rbi

@@ -14,17 +14,22 @@ module Orb
           )
         end
 
+      sig { returns(String) }
+      attr_accessor :subscription_id
+
       # Price for which the updates should be cleared. Must be a fixed fee.
       sig { returns(String) }
       attr_accessor :price_id
 
       sig do
         params(
+          subscription_id: String,
           price_id: String,
           request_options: Orb::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        subscription_id:,
         # Price for which the updates should be cleared. Must be a fixed fee.
         price_id:,
         request_options: {}
@@ -33,7 +38,11 @@ module Orb
 
       sig do
         override.returns(
-          { price_id: String, request_options: Orb::RequestOptions }
+          {
+            subscription_id: String,
+            price_id: String,
+            request_options: Orb::RequestOptions
+          }
         )
       end
       def to_hash

data/rbi/orb/models/subscription_unschedule_pending_plan_changes_params.rbi

@@ -14,15 +14,23 @@ module Orb
           )
         end
 
+      sig { returns(String) }
+      attr_accessor :subscription_id
+
       sig do
-        params(request_options: Orb::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          subscription_id: String,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(subscription_id:, request_options: {})
       end
 
-      sig { override.returns({ request_options: Orb::RequestOptions }) }
+      sig do
+        override.returns(
+          { subscription_id: String, request_options: Orb::RequestOptions }
+        )
+      end
       def to_hash
       end
     end

data/rbi/orb/models/subscription_update_fixed_fee_quantity_params.rbi

@@ -14,6 +14,9 @@ module Orb
           )
         end
 
+      sig { returns(String) }
+      attr_accessor :subscription_id
+
       # Price for which the quantity should be updated. Must be a fixed fee.
       sig { returns(String) }
       attr_accessor :price_id
@@ -55,6 +58,7 @@ module Orb
 
       sig do
         params(
+          subscription_id: String,
           price_id: String,
           quantity: Float,
           allow_invoice_credit_or_void: T.nilable(T::Boolean),
@@ -65,6 +69,7 @@ module Orb
         ).returns(T.attached_class)
       end
       def self.new(
+        subscription_id:,
         # Price for which the quantity should be updated. Must be a fixed fee.
         price_id:,
         quantity:,
@@ -87,6 +92,7 @@ module Orb
       sig do
         override.returns(
           {
+            subscription_id: String,
             price_id: String,
             quantity: Float,
             allow_invoice_credit_or_void: T.nilable(T::Boolean),

data/rbi/orb/models/subscription_update_params.rbi

@@ -11,12 +11,22 @@ module Orb
           T.any(Orb::SubscriptionUpdateParams, Orb::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :subscription_id
+
       # Determines whether issued invoices for this subscription will automatically be
       # charged with the saved payment method on the due date. This property defaults to
       # the plan's behavior.
       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)) }
@@ -43,7 +53,9 @@ module Orb
 
       sig do
         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)]),
@@ -52,10 +64,16 @@ module Orb
         ).returns(T.attached_class)
       end
       def self.new(
+        subscription_id:,
         # Determines whether issued invoices for this subscription will automatically be
         # 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,
@@ -79,7 +97,9 @@ module Orb
       sig do
         override.returns(
           {
+            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/subscription_update_trial_params.rbi

@@ -11,6 +11,9 @@ module Orb
           T.any(Orb::SubscriptionUpdateTrialParams, Orb::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :subscription_id
+
       # The new date that the trial should end, or the literal string `immediate` to end
       # the trial immediately.
       sig do
@@ -33,6 +36,7 @@ module Orb
 
       sig do
         params(
+          subscription_id: String,
           trial_end_date:
             T.any(
               Time,
@@ -43,6 +47,7 @@ module Orb
         ).returns(T.attached_class)
       end
       def self.new(
+        subscription_id:,
         # The new date that the trial should end, or the literal string `immediate` to end
         # the trial immediately.
         trial_end_date:,
@@ -56,6 +61,7 @@ module Orb
       sig do
         override.returns(
           {
+            subscription_id: String,
             trial_end_date:
               T.any(
                 Time,

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,7 +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),
+          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
@@ -163,8 +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,
+        # 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/coupons.rbi

@@ -49,8 +49,7 @@ module Orb
       #
       # The list of coupons is ordered starting from the most recently created coupon.
       # The response also includes `pagination_metadata`, 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.
+      # the next page of results if they exist.
       sig do
         params(
           cursor: T.nilable(String),

data/rbi/orb/resources/credit_blocks.rbi

@@ -41,14 +41,17 @@ module Orb
 
       # This endpoint returns the credit block and its associated purchasing invoices.
       #
-      # If a credit block was purchased (as opposed to being manually added or allocated
-      # from a subscription), this endpoint returns the invoices that were created to
-      # charge the customer for the credit block. For credit blocks with payment
-      # schedules spanning multiple periods (e.g., monthly payments over 12 months),
-      # multiple invoices will be returned.
+      # If a credit block was purchased (as opposed to being manually added), this
+      # endpoint returns the invoices that were created to charge the customer for the
+      # credit block. For credit blocks with payment schedules spanning multiple periods
+      # (e.g., monthly payments over 12 months), multiple invoices will be returned.
       #
-      # If the credit block was not purchased (e.g., manual increment, allocation), an
-      # empty invoices list is returned.
+      # For credit blocks created by subscription allocation prices, this endpoint
+      # returns the subscription invoice containing the allocation line item that
+      # created the block.
+      #
+      # If the credit block was not purchased (e.g., manual increment), an empty
+      # invoices list is returned.
       #
       # **Note: This endpoint is currently experimental and its interface may change in
       # future releases. Please contact support before building production integrations

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
           #
@@ -182,7 +183,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
@@ -192,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.
           #
@@ -250,79 +259,20 @@ module Orb
           sig do
             params(
               customer_id: String,
-              amount: Float,
-              entry_type:
-                Orb::Customers::Credits::LedgerCreateEntryParams::EntryType::OrSymbol,
-              target_expiry_date: Date,
-              block_id: String,
-              currency: T.nilable(String),
-              description: T.nilable(String),
-              effective_date: T.nilable(Time),
-              expiry_date: T.nilable(Time),
-              filters:
-                T.nilable(
-                  T::Array[
-                    Orb::Customers::Credits::LedgerCreateEntryParams::Filter::OrHash
-                  ]
-                ),
-              invoice_settings:
-                T.nilable(
-                  Orb::Customers::Credits::LedgerCreateEntryParams::InvoiceSettings::OrHash
-                ),
-              metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
-              per_unit_cost_basis: T.nilable(String),
-              void_reason:
-                T.nilable(
-                  Orb::Customers::Credits::LedgerCreateEntryParams::VoidReason::OrSymbol
+              body:
+                T.any(
+                  Orb::Customers::Credits::LedgerCreateEntryParams::Body::Increment::OrHash,
+                  Orb::Customers::Credits::LedgerCreateEntryParams::Body::Decrement::OrHash,
+                  Orb::Customers::Credits::LedgerCreateEntryParams::Body::ExpirationChange::OrHash,
+                  Orb::Customers::Credits::LedgerCreateEntryParams::Body::Void::OrHash,
+                  Orb::Customers::Credits::LedgerCreateEntryParams::Body::Amendment::OrHash
                 ),
               request_options: Orb::RequestOptions::OrHash
             ).returns(
               Orb::Models::Customers::Credits::LedgerCreateEntryResponse::Variants
             )
           end
-          def create_entry(
-            customer_id,
-            # The number of credits to effect. Note that this is required for increment,
-            # decrement or void operations.
-            amount:,
-            entry_type:,
-            # A future date (specified in YYYY-MM-DD format) used for expiration change,
-            # denoting when credits transferred (as part of a partial block expiration) should
-            # expire.
-            target_expiry_date:,
-            # The ID of the block to reverse a decrement from.
-            block_id:,
-            # The currency or custom pricing unit to use for this ledger entry. If this is a
-            # real-world currency, it must match the customer's invoicing currency.
-            currency: nil,
-            # Optional metadata that can be specified when adding ledger results via the API.
-            # For example, this can be used to note an increment refers to trial credits, or
-            # for noting corrections as a result of an incident, etc.
-            description: nil,
-            # An ISO 8601 format date that denotes when this credit balance should become
-            # available for use.
-            effective_date: nil,
-            # An ISO 8601 format date that identifies the origination credit block to expire
-            expiry_date: nil,
-            # Optional filter to specify which items this credit block applies to. If not
-            # specified, the block will apply to all items for the pricing unit.
-            filters: nil,
-            # Passing `invoice_settings` automatically generates an invoice for the newly
-            # added credits. If `invoice_settings` is passed, you must specify
-            # per_unit_cost_basis, as the calculation of the invoice total is done on that
-            # basis.
-            invoice_settings: nil,
-            # User-specified key/value pairs for the resource. Individual keys can be removed
-            # by setting the value to `null`, and the entire metadata mapping can be cleared
-            # by setting `metadata` to `null`.
-            metadata: nil,
-            # Can only be specified when entry_type=increment. How much, in the customer's
-            # currency, a customer paid for a single credit in this block
-            per_unit_cost_basis: nil,
-            # Can only be specified when `entry_type=void`. The reason for the void.
-            void_reason: nil,
-            request_options: {}
-          )
+          def create_entry(customer_id, body:, request_options: {})
           end
 
           # This endpoint allows you to create a new ledger entry for a specified customer's
@@ -365,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
           #
@@ -375,7 +326,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
@@ -385,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.
           #
@@ -443,30 +402,13 @@ module Orb
           sig do
             params(
               external_customer_id: String,
-              amount: Float,
-              entry_type:
-                Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::EntryType::OrSymbol,
-              target_expiry_date: Date,
-              block_id: String,
-              currency: T.nilable(String),
-              description: T.nilable(String),
-              effective_date: T.nilable(Time),
-              expiry_date: T.nilable(Time),
-              filters:
-                T.nilable(
-                  T::Array[
-                    Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::Filter::OrHash
-                  ]
-                ),
-              invoice_settings:
-                T.nilable(
-                  Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::InvoiceSettings::OrHash
-                ),
-              metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
-              per_unit_cost_basis: T.nilable(String),
-              void_reason:
-                T.nilable(
-                  Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::VoidReason::OrSymbol
+              body:
+                T.any(
+                  Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::Body::Increment::OrHash,
+                  Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::Body::Decrement::OrHash,
+                  Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::Body::ExpirationChange::OrHash,
+                  Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::Body::Void::OrHash,
+                  Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::Body::Amendment::OrHash
                 ),
               request_options: Orb::RequestOptions::OrHash
             ).returns(
@@ -475,45 +417,7 @@ module Orb
           end
           def create_entry_by_external_id(
             external_customer_id,
-            # The number of credits to effect. Note that this is required for increment,
-            # decrement or void operations.
-            amount:,
-            entry_type:,
-            # A future date (specified in YYYY-MM-DD format) used for expiration change,
-            # denoting when credits transferred (as part of a partial block expiration) should
-            # expire.
-            target_expiry_date:,
-            # The ID of the block to reverse a decrement from.
-            block_id:,
-            # The currency or custom pricing unit to use for this ledger entry. If this is a
-            # real-world currency, it must match the customer's invoicing currency.
-            currency: nil,
-            # Optional metadata that can be specified when adding ledger results via the API.
-            # For example, this can be used to note an increment refers to trial credits, or
-            # for noting corrections as a result of an incident, etc.
-            description: nil,
-            # An ISO 8601 format date that denotes when this credit balance should become
-            # available for use.
-            effective_date: nil,
-            # An ISO 8601 format date that identifies the origination credit block to expire
-            expiry_date: nil,
-            # Optional filter to specify which items this credit block applies to. If not
-            # specified, the block will apply to all items for the pricing unit.
-            filters: nil,
-            # Passing `invoice_settings` automatically generates an invoice for the newly
-            # added credits. If `invoice_settings` is passed, you must specify
-            # per_unit_cost_basis, as the calculation of the invoice total is done on that
-            # basis.
-            invoice_settings: nil,
-            # User-specified key/value pairs for the resource. Individual keys can be removed
-            # by setting the value to `null`, and the entire metadata mapping can be cleared
-            # by setting `metadata` to `null`.
-            metadata: nil,
-            # Can only be specified when entry_type=increment. How much, in the customer's
-            # currency, a customer paid for a single credit in this block
-            per_unit_cost_basis: nil,
-            # Can only be specified when `entry_type=void`. The reason for the void.
-            void_reason: nil,
+            body:,
             request_options: {}
           )
           end