modern_treasury 0.1.0.pre.alpha.15 → 0.1.0.pre.alpha.17

data/lib/modern_treasury/resources/internal_accounts/balance_reports.rb

@@ -6,28 +6,24 @@ module ModernTreasury
       class BalanceReports
         # create balance reports
         #
-        # @param internal_account_id [String]
-        #
-        # @param params [ModernTreasury::Models::InternalAccounts::BalanceReportCreateParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [Date] :as_of_date The date of the balance report in local time.
-        #
-        #   @option params [String] :as_of_time The time (24-hour clock) of the balance report in local time.
-        #
-        #   @option params [Symbol, ModernTreasury::Models::InternalAccounts::BalanceReportCreateParams::BalanceReportType] :balance_report_type The specific type of balance report. One of `intraday`, `previous_day`,
-        #     `real_time`, or `other`.
-        #
-        #   @option params [Array<ModernTreasury::Models::InternalAccounts::BalanceReportCreateParams::Balance>] :balances An array of `Balance` objects.
+        # @overload create(internal_account_id, as_of_date:, as_of_time:, balance_report_type:, balances:, request_options: {})
         #
-        #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param internal_account_id [String]
+        # @param as_of_date [Date]
+        # @param as_of_time [String]
+        # @param balance_report_type [Symbol, ModernTreasury::Models::InternalAccounts::BalanceReportCreateParams::BalanceReportType]
+        # @param balances [Array<ModernTreasury::Models::InternalAccounts::BalanceReportCreateParams::Balance>]
+        # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [ModernTreasury::Models::InternalAccounts::BalanceReport]
         #
+        # @see ModernTreasury::Models::InternalAccounts::BalanceReportCreateParams
         def create(internal_account_id, params)
-          parsed, options = ModernTreasury::Models::InternalAccounts::BalanceReportCreateParams.dump_request(params)
+          parsed, options =
+            ModernTreasury::Models::InternalAccounts::BalanceReportCreateParams.dump_request(params)
           @client.request(
             method: :post,
-            path: ["api/internal_accounts/%0s/balance_reports", internal_account_id],
+            path: ["api/internal_accounts/%1$s/balance_reports", internal_account_id],
             body: parsed,
             model: ModernTreasury::Models::InternalAccounts::BalanceReport,
             options: options
@@ -36,25 +32,25 @@ module ModernTreasury
 
         # Get a single balance report for a given internal account.
         #
-        # @param id [String] Either the unique identifier of the balance report or latest for the latest
-        #   balance report.
-        #
-        # @param params [ModernTreasury::Models::InternalAccounts::BalanceReportRetrieveParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [String] :internal_account_id
+        # @overload retrieve(id, internal_account_id:, request_options: {})
         #
-        #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param id [String]
+        # @param internal_account_id [String]
+        # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [ModernTreasury::Models::InternalAccounts::BalanceReport]
         #
+        # @see ModernTreasury::Models::InternalAccounts::BalanceReportRetrieveParams
         def retrieve(id, params)
-          parsed, options = ModernTreasury::Models::InternalAccounts::BalanceReportRetrieveParams.dump_request(params)
-          internal_account_id = parsed.fetch(:internal_account_id) do
-            raise ArgumentError.new("missing required path argument #{_1}")
-          end
+          parsed, options =
+            ModernTreasury::Models::InternalAccounts::BalanceReportRetrieveParams.dump_request(params)
+          internal_account_id =
+            parsed.delete(:internal_account_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
           @client.request(
             method: :get,
-            path: ["api/internal_accounts/%0s/balance_reports/%1s", internal_account_id, id],
+            path: ["api/internal_accounts/%1$s/balance_reports/%2$s", internal_account_id, id],
             model: ModernTreasury::Models::InternalAccounts::BalanceReport,
             options: options
           )
@@ -62,30 +58,25 @@ module ModernTreasury
 
         # Get all balance reports for a given internal account.
         #
-        # @param internal_account_id [String]
-        #
-        # @param params [ModernTreasury::Models::InternalAccounts::BalanceReportListParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [String, nil] :after_cursor
-        #
-        #   @option params [Date] :as_of_date The date of the balance report in local time.
+        # @overload list(internal_account_id, after_cursor: nil, as_of_date: nil, balance_report_type: nil, per_page: nil, request_options: {})
         #
-        #   @option params [Symbol, ModernTreasury::Models::InternalAccounts::BalanceReportListParams::BalanceReportType] :balance_report_type The specific type of balance report. One of `intraday`, `previous_day`,
-        #     `real_time`, or `other`.
-        #
-        #   @option params [Integer] :per_page
-        #
-        #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param internal_account_id [String]
+        # @param after_cursor [String, nil]
+        # @param as_of_date [Date]
+        # @param balance_report_type [Symbol, ModernTreasury::Models::InternalAccounts::BalanceReportListParams::BalanceReportType]
+        # @param per_page [Integer]
+        # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [ModernTreasury::Page<ModernTreasury::Models::InternalAccounts::BalanceReport>]
+        # @return [ModernTreasury::Internal::Page<ModernTreasury::Models::InternalAccounts::BalanceReport>]
         #
+        # @see ModernTreasury::Models::InternalAccounts::BalanceReportListParams
         def list(internal_account_id, params = {})
           parsed, options = ModernTreasury::Models::InternalAccounts::BalanceReportListParams.dump_request(params)
           @client.request(
             method: :get,
-            path: ["api/internal_accounts/%0s/balance_reports", internal_account_id],
+            path: ["api/internal_accounts/%1$s/balance_reports", internal_account_id],
             query: parsed,
-            page: ModernTreasury::Page,
+            page: ModernTreasury::Internal::Page,
             model: ModernTreasury::Models::InternalAccounts::BalanceReport,
             options: options
           )
@@ -93,32 +84,33 @@ module ModernTreasury
 
         # Deletes a given balance report.
         #
-        # @param id [String] Either the unique identifier of the balance report or latest for the latest
-        #   balance report.
+        # @overload delete(id, internal_account_id:, request_options: {})
         #
-        # @param params [ModernTreasury::Models::InternalAccounts::BalanceReportDeleteParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [String] :internal_account_id
-        #
-        #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param id [String]
+        # @param internal_account_id [String]
+        # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]
         #
+        # @see ModernTreasury::Models::InternalAccounts::BalanceReportDeleteParams
         def delete(id, params)
-          parsed, options = ModernTreasury::Models::InternalAccounts::BalanceReportDeleteParams.dump_request(params)
-          internal_account_id = parsed.fetch(:internal_account_id) do
-            raise ArgumentError.new("missing required path argument #{_1}")
-          end
+          parsed, options =
+            ModernTreasury::Models::InternalAccounts::BalanceReportDeleteParams.dump_request(params)
+          internal_account_id =
+            parsed.delete(:internal_account_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
           @client.request(
             method: :delete,
-            path: ["api/internal_accounts/%0s/balance_reports/%1s", internal_account_id, id],
+            path: ["api/internal_accounts/%1$s/balance_reports/%2$s", internal_account_id, id],
             model: NilClass,
             options: options
           )
         end
 
-        # @param client [ModernTreasury::Client]
+        # @api private
         #
+        # @param client [ModernTreasury::Client]
         def initialize(client:)
           @client = client
         end

data/lib/modern_treasury/resources/internal_accounts.rb

@@ -8,32 +8,22 @@ module ModernTreasury
 
       # create internal account
       #
-      # @param params [ModernTreasury::Models::InternalAccountCreateParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :connection_id The identifier of the financial institution the account belongs to.
-      #
-      #   @option params [Symbol, ModernTreasury::Models::InternalAccountCreateParams::Currency] :currency Either "USD" or "CAD". Internal accounts created at Increase only supports
-      #     "USD".
-      #
-      #   @option params [String] :name The nickname of the account.
-      #
-      #   @option params [String] :party_name The legal name of the entity which owns the account.
-      #
-      #   @option params [String] :counterparty_id The Counterparty associated to this account.
-      #
-      #   @option params [String] :legal_entity_id The LegalEntity associated to this account.
-      #
-      #   @option params [String] :parent_account_id The parent internal account of this new account.
-      #
-      #   @option params [ModernTreasury::Models::InternalAccountCreateParams::PartyAddress] :party_address The address associated with the owner or null.
-      #
-      #   @option params [Hash{Symbol=>String}] :vendor_attributes A hash of vendor specific attributes that will be used when creating the account
-      #     at the vendor specified by the given connection.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @overload create(connection_id:, currency:, name:, party_name:, counterparty_id: nil, legal_entity_id: nil, parent_account_id: nil, party_address: nil, vendor_attributes: nil, request_options: {})
+      #
+      # @param connection_id [String]
+      # @param currency [Symbol, ModernTreasury::Models::InternalAccountCreateParams::Currency]
+      # @param name [String]
+      # @param party_name [String]
+      # @param counterparty_id [String]
+      # @param legal_entity_id [String]
+      # @param parent_account_id [String]
+      # @param party_address [ModernTreasury::Models::InternalAccountCreateParams::PartyAddress]
+      # @param vendor_attributes [Hash{Symbol=>String}]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::InternalAccount]
       #
+      # @see ModernTreasury::Models::InternalAccountCreateParams
       def create(params)
         parsed, options = ModernTreasury::Models::InternalAccountCreateParams.dump_request(params)
         @client.request(
@@ -47,18 +37,18 @@ module ModernTreasury
 
       # get internal account
       #
-      # @param id [String] Unique identifier for the account.
-      #
-      # @param params [ModernTreasury::Models::InternalAccountRetrieveParams, Hash{Symbol=>Object}] .
+      # @overload retrieve(id, request_options: {})
       #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param id [String]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::InternalAccount]
       #
+      # @see ModernTreasury::Models::InternalAccountRetrieveParams
       def retrieve(id, params = {})
         @client.request(
           method: :get,
-          path: ["api/internal_accounts/%0s", id],
+          path: ["api/internal_accounts/%1$s", id],
           model: ModernTreasury::Models::InternalAccount,
           options: params[:request_options]
         )
@@ -66,30 +56,24 @@ module ModernTreasury
 
       # update internal account
       #
-      # @param id [String] Unique identifier for the account.
-      #
-      # @param params [ModernTreasury::Models::InternalAccountUpdateParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :counterparty_id The Counterparty associated to this account.
-      #
-      #   @option params [String] :ledger_account_id The Ledger Account associated to this account.
+      # @overload update(id, counterparty_id: nil, ledger_account_id: nil, metadata: nil, name: nil, parent_account_id: nil, request_options: {})
       #
-      #   @option params [Hash{Symbol=>String}] :metadata Additional data in the form of key-value pairs. Pairs can be removed by passing
-      #     an empty string or `null` as the value.
-      #
-      #   @option params [String] :name The nickname for the internal account.
-      #
-      #   @option params [String] :parent_account_id The parent internal account for this account.
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param id [String]
+      # @param counterparty_id [String]
+      # @param ledger_account_id [String]
+      # @param metadata [Hash{Symbol=>String}]
+      # @param name [String]
+      # @param parent_account_id [String]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ModernTreasury::Models::InternalAccount]
       #
+      # @see ModernTreasury::Models::InternalAccountUpdateParams
       def update(id, params = {})
         parsed, options = ModernTreasury::Models::InternalAccountUpdateParams.dump_request(params)
         @client.request(
           method: :patch,
-          path: ["api/internal_accounts/%0s", id],
+          path: ["api/internal_accounts/%1$s", id],
           body: parsed,
           model: ModernTreasury::Models::InternalAccount,
           options: options
@@ -98,44 +82,36 @@ module ModernTreasury
 
       # list internal accounts
       #
-      # @param params [ModernTreasury::Models::InternalAccountListParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String, nil] :after_cursor
-      #
-      #   @option params [String] :counterparty_id Only return internal accounts associated with this counterparty.
-      #
-      #   @option params [Symbol, ModernTreasury::Models::Currency] :currency Only return internal accounts with this currency.
-      #
-      #   @option params [String] :legal_entity_id Only return internal accounts associated with this legal entity.
+      # @overload list(after_cursor: nil, counterparty_id: nil, currency: nil, legal_entity_id: nil, metadata: nil, payment_direction: nil, payment_type: nil, per_page: nil, request_options: {})
       #
-      #   @option params [Hash{Symbol=>String}] :metadata For example, if you want to query for records with metadata key `Type` and value
-      #     `Loan`, the query would be `metadata%5BType%5D=Loan`. This encodes the query
-      #     parameters.
+      # @param after_cursor [String, nil]
+      # @param counterparty_id [String]
+      # @param currency [Symbol, ModernTreasury::Models::Currency]
+      # @param legal_entity_id [String]
+      # @param metadata [Hash{Symbol=>String}]
+      # @param payment_direction [Symbol, ModernTreasury::Models::TransactionDirection]
+      # @param payment_type [Symbol, ModernTreasury::Models::InternalAccountListParams::PaymentType]
+      # @param per_page [Integer]
+      # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      #   @option params [Symbol, ModernTreasury::Models::TransactionDirection] :payment_direction Only return internal accounts that can originate payments with this direction.
-      #
-      #   @option params [Symbol, ModernTreasury::Models::InternalAccountListParams::PaymentType] :payment_type Only return internal accounts that can make this type of payment.
-      #
-      #   @option params [Integer] :per_page
-      #
-      #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
-      #
-      # @return [ModernTreasury::Page<ModernTreasury::Models::InternalAccount>]
+      # @return [ModernTreasury::Internal::Page<ModernTreasury::Models::InternalAccount>]
       #
+      # @see ModernTreasury::Models::InternalAccountListParams
       def list(params = {})
         parsed, options = ModernTreasury::Models::InternalAccountListParams.dump_request(params)
         @client.request(
           method: :get,
           path: "api/internal_accounts",
           query: parsed,
-          page: ModernTreasury::Page,
+          page: ModernTreasury::Internal::Page,
           model: ModernTreasury::Models::InternalAccount,
           options: options
         )
       end
 
-      # @param client [ModernTreasury::Client]
+      # @api private
       #
+      # @param client [ModernTreasury::Client]
       def initialize(client:)
         @client = client
         @balance_reports = ModernTreasury::Resources::InternalAccounts::BalanceReports.new(client: client)

data/lib/modern_treasury/resources/invoices/line_items.rb

@@ -6,40 +6,26 @@ module ModernTreasury
       class LineItems
         # create invoice_line_item
         #
-        # @param invoice_id [String] invoice_id
-        #
-        # @param params [ModernTreasury::Models::Invoices::LineItemCreateParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [String] :name The name of the line item, typically a product or SKU name.
-        #
-        #   @option params [Integer] :unit_amount The cost per unit of the product or service that this line item is for,
-        #     specified in the invoice currency's smallest unit.
-        #
-        #   @option params [String] :description An optional free-form description of the line item.
-        #
-        #   @option params [String] :direction Either `debit` or `credit`. `debit` indicates that a client owes the business
-        #     money and increases the invoice's `total_amount` due. `credit` has the opposite
-        #     intention and effect.
-        #
-        #   @option params [Hash{Symbol=>String}] :metadata Additional data represented as key-value pairs. Both the key and value must be
-        #     strings.
-        #
-        #   @option params [Integer] :quantity The number of units of a product or service that this line item is for. Must be
-        #     a whole number. Defaults to 1 if not provided.
-        #
-        #   @option params [String] :unit_amount_decimal The cost per unit of the product or service that this line item is for,
-        #     specified in the invoice currency's smallest unit. Accepts decimal strings with
-        #     up to 12 decimals
-        #
-        #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @overload create(invoice_id, name:, unit_amount:, description: nil, direction: nil, metadata: nil, quantity: nil, unit_amount_decimal: nil, request_options: {})
+        #
+        # @param invoice_id [String]
+        # @param name [String]
+        # @param unit_amount [Integer]
+        # @param description [String]
+        # @param direction [String]
+        # @param metadata [Hash{Symbol=>String}]
+        # @param quantity [Integer]
+        # @param unit_amount_decimal [String]
+        # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [ModernTreasury::Models::Invoices::InvoiceLineItem]
         #
+        # @see ModernTreasury::Models::Invoices::LineItemCreateParams
         def create(invoice_id, params)
           parsed, options = ModernTreasury::Models::Invoices::LineItemCreateParams.dump_request(params)
           @client.request(
             method: :post,
-            path: ["api/invoices/%0s/invoice_line_items", invoice_id],
+            path: ["api/invoices/%1$s/invoice_line_items", invoice_id],
             body: parsed,
             model: ModernTreasury::Models::Invoices::InvoiceLineItem,
             options: options
@@ -48,24 +34,24 @@ module ModernTreasury
 
         # get invoice_line_item
         #
-        # @param id [String] id
-        #
-        # @param params [ModernTreasury::Models::Invoices::LineItemRetrieveParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [String] :invoice_id invoice_id
+        # @overload retrieve(id, invoice_id:, request_options: {})
         #
-        #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param id [String]
+        # @param invoice_id [String]
+        # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [ModernTreasury::Models::Invoices::InvoiceLineItem]
         #
+        # @see ModernTreasury::Models::Invoices::LineItemRetrieveParams
         def retrieve(id, params)
           parsed, options = ModernTreasury::Models::Invoices::LineItemRetrieveParams.dump_request(params)
-          invoice_id = parsed.fetch(:invoice_id) do
-            raise ArgumentError.new("missing required path argument #{_1}")
-          end
+          invoice_id =
+            parsed.delete(:invoice_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
           @client.request(
             method: :get,
-            path: ["api/invoices/%0s/invoice_line_items/%1s", invoice_id, id],
+            path: ["api/invoices/%1$s/invoice_line_items/%2$s", invoice_id, id],
             model: ModernTreasury::Models::Invoices::InvoiceLineItem,
             options: options
           )
@@ -73,46 +59,32 @@ module ModernTreasury
 
         # update invoice_line_item
         #
-        # @param id [String] Path param: id
-        #
-        # @param params [ModernTreasury::Models::Invoices::LineItemUpdateParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [String] :invoice_id Path param: invoice_id
-        #
-        #   @option params [String] :description Body param: An optional free-form description of the line item.
+        # @overload update(id, invoice_id:, description: nil, direction: nil, metadata: nil, name: nil, quantity: nil, unit_amount: nil, unit_amount_decimal: nil, request_options: {})
         #
-        #   @option params [String] :direction Body param: Either `debit` or `credit`. `debit` indicates that a client owes the
-        #     business money and increases the invoice's `total_amount` due. `credit` has the
-        #     opposite intention and effect.
-        #
-        #   @option params [Hash{Symbol=>String}] :metadata Body param: Additional data represented as key-value pairs. Both the key and
-        #     value must be strings.
-        #
-        #   @option params [String] :name Body param: The name of the line item, typically a product or SKU name.
-        #
-        #   @option params [Integer] :quantity Body param: The number of units of a product or service that this line item is
-        #     for. Must be a whole number. Defaults to 1 if not provided.
-        #
-        #   @option params [Integer] :unit_amount Body param: The cost per unit of the product or service that this line item is
-        #     for, specified in the invoice currency's smallest unit.
-        #
-        #   @option params [String] :unit_amount_decimal Body param: The cost per unit of the product or service that this line item is
-        #     for, specified in the invoice currency's smallest unit. Accepts decimal strings
-        #     with up to 12 decimals
-        #
-        #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param id [String]
+        # @param invoice_id [String]
+        # @param description [String]
+        # @param direction [String]
+        # @param metadata [Hash{Symbol=>String}]
+        # @param name [String]
+        # @param quantity [Integer]
+        # @param unit_amount [Integer]
+        # @param unit_amount_decimal [String]
+        # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [ModernTreasury::Models::Invoices::InvoiceLineItem]
         #
+        # @see ModernTreasury::Models::Invoices::LineItemUpdateParams
         def update(id, params)
           parsed, options = ModernTreasury::Models::Invoices::LineItemUpdateParams.dump_request(params)
-          invoice_id = parsed.fetch(:invoice_id) do
-            raise ArgumentError.new("missing required path argument #{_1}")
-          end
+          invoice_id =
+            parsed.delete(:invoice_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
           @client.request(
             method: :patch,
-            path: ["api/invoices/%0s/invoice_line_items/%1s", invoice_id, id],
-            body: parsed.except(:invoice_id),
+            path: ["api/invoices/%1$s/invoice_line_items/%2$s", invoice_id, id],
+            body: parsed,
             model: ModernTreasury::Models::Invoices::InvoiceLineItem,
             options: options
           )
@@ -120,25 +92,23 @@ module ModernTreasury
 
         # list invoice_line_items
         #
-        # @param invoice_id [String] invoice_id
+        # @overload list(invoice_id, after_cursor: nil, per_page: nil, request_options: {})
         #
-        # @param params [ModernTreasury::Models::Invoices::LineItemListParams, Hash{Symbol=>Object}] .
+        # @param invoice_id [String]
+        # @param after_cursor [String, nil]
+        # @param per_page [Integer]
+        # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        #   @option params [String, nil] :after_cursor
-        #
-        #   @option params [Integer] :per_page
-        #
-        #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
-        #
-        # @return [ModernTreasury::Page<ModernTreasury::Models::Invoices::InvoiceLineItem>]
+        # @return [ModernTreasury::Internal::Page<ModernTreasury::Models::Invoices::InvoiceLineItem>]
         #
+        # @see ModernTreasury::Models::Invoices::LineItemListParams
         def list(invoice_id, params = {})
           parsed, options = ModernTreasury::Models::Invoices::LineItemListParams.dump_request(params)
           @client.request(
             method: :get,
-            path: ["api/invoices/%0s/invoice_line_items", invoice_id],
+            path: ["api/invoices/%1$s/invoice_line_items", invoice_id],
             query: parsed,
-            page: ModernTreasury::Page,
+            page: ModernTreasury::Internal::Page,
             model: ModernTreasury::Models::Invoices::InvoiceLineItem,
             options: options
           )
@@ -146,31 +116,32 @@ module ModernTreasury
 
         # delete invoice_line_item
         #
-        # @param id [String] id
-        #
-        # @param params [ModernTreasury::Models::Invoices::LineItemDeleteParams, Hash{Symbol=>Object}] .
+        # @overload delete(id, invoice_id:, request_options: {})
         #
-        #   @option params [String] :invoice_id invoice_id
-        #
-        #   @option params [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param id [String]
+        # @param invoice_id [String]
+        # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [ModernTreasury::Models::Invoices::InvoiceLineItem]
         #
+        # @see ModernTreasury::Models::Invoices::LineItemDeleteParams
         def delete(id, params)
           parsed, options = ModernTreasury::Models::Invoices::LineItemDeleteParams.dump_request(params)
-          invoice_id = parsed.fetch(:invoice_id) do
-            raise ArgumentError.new("missing required path argument #{_1}")
-          end
+          invoice_id =
+            parsed.delete(:invoice_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
           @client.request(
             method: :delete,
-            path: ["api/invoices/%0s/invoice_line_items/%1s", invoice_id, id],
+            path: ["api/invoices/%1$s/invoice_line_items/%2$s", invoice_id, id],
             model: ModernTreasury::Models::Invoices::InvoiceLineItem,
             options: options
           )
         end
 
-        # @param client [ModernTreasury::Client]
+        # @api private
         #
+        # @param client [ModernTreasury::Client]
         def initialize(client:)
           @client = client
         end