lithic 0.1.0.pre.alpha.2 → 0.1.0.pre.alpha.4

data/lib/lithic/resources/financial_accounts/financial_transactions.rb

@@ -6,15 +6,15 @@ module Lithic
       class FinancialTransactions
         # Get the financial transaction for the provided token.
         #
-        # @param financial_transaction_token [String] Globally unique identifier for financial transaction token.
+        # @overload retrieve(financial_transaction_token, financial_account_token:, request_options: {})
         #
-        # @param params [Lithic::Models::FinancialAccounts::FinancialTransactionRetrieveParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [String] :financial_account_token Globally unique identifier for financial account.
-        #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param financial_transaction_token [String]
+        # @param financial_account_token [String]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::Models::FinancialTransaction]
+        #
+        # @see Lithic::Models::FinancialAccounts::FinancialTransactionRetrieveParams
         def retrieve(financial_transaction_token, params)
           parsed, options =
             Lithic::Models::FinancialAccounts::FinancialTransactionRetrieveParams.dump_request(params)
@@ -25,7 +25,7 @@ module Lithic
           @client.request(
             method: :get,
             path: [
-              "v1/financial_accounts/%0s/financial_transactions/%1s",
+              "v1/financial_accounts/%1$s/financial_transactions/%2$s",
               financial_account_token,
               financial_transaction_token
             ],
@@ -36,36 +36,26 @@ module Lithic
 
         # List the financial transactions for a given financial account.
         #
-        # @param financial_account_token [String] Globally unique identifier for financial account.
-        #
-        # @param params [Lithic::Models::FinancialAccounts::FinancialTransactionListParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [Time] :begin_ Date string in RFC 3339 format. Only entries created after the specified time
-        #     will be included. UTC time zone.
-        #
-        #   @option params [Symbol, Lithic::Models::FinancialAccounts::FinancialTransactionListParams::Category] :category Financial Transaction category to be returned.
-        #
-        #   @option params [Time] :end_ Date string in RFC 3339 format. Only entries created before the specified time
-        #     will be included. UTC time zone.
+        # @overload list(financial_account_token, begin_: nil, category: nil, end_: nil, ending_before: nil, result: nil, starting_after: nil, status: nil, request_options: {})
         #
-        #   @option params [String] :ending_before A cursor representing an item's token before which a page of results should end.
-        #     Used to retrieve the previous page of results before this item.
-        #
-        #   @option params [Symbol, Lithic::Models::FinancialAccounts::FinancialTransactionListParams::Result] :result Financial Transaction result to be returned.
-        #
-        #   @option params [String] :starting_after A cursor representing an item's token after which a page of results should
-        #     begin. Used to retrieve the next page of results after this item.
-        #
-        #   @option params [Symbol, Lithic::Models::FinancialAccounts::FinancialTransactionListParams::Status] :status Financial Transaction status to be returned.
-        #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param financial_account_token [String]
+        # @param begin_ [Time]
+        # @param category [Symbol, Lithic::Models::FinancialAccounts::FinancialTransactionListParams::Category]
+        # @param end_ [Time]
+        # @param ending_before [String]
+        # @param result [Symbol, Lithic::Models::FinancialAccounts::FinancialTransactionListParams::Result]
+        # @param starting_after [String]
+        # @param status [Symbol, Lithic::Models::FinancialAccounts::FinancialTransactionListParams::Status]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::SinglePage<Lithic::Models::FinancialTransaction>]
+        #
+        # @see Lithic::Models::FinancialAccounts::FinancialTransactionListParams
         def list(financial_account_token, params = {})
           parsed, options = Lithic::Models::FinancialAccounts::FinancialTransactionListParams.dump_request(params)
           @client.request(
             method: :get,
-            path: ["v1/financial_accounts/%0s/financial_transactions", financial_account_token],
+            path: ["v1/financial_accounts/%1$s/financial_transactions", financial_account_token],
             query: parsed,
             page: Lithic::SinglePage,
             model: Lithic::Models::FinancialTransaction,
@@ -73,6 +63,8 @@ module Lithic
           )
         end
 
+        # @api private
+        #
         # @param client [Lithic::Client]
         def initialize(client:)
           @client = client

data/lib/lithic/resources/financial_accounts/loan_tapes.rb

@@ -6,15 +6,15 @@ module Lithic
       class LoanTapes
         # Get a specific loan tape for a given financial account.
         #
-        # @param loan_tape_token [String] Globally unique identifier for loan tape.
+        # @overload retrieve(loan_tape_token, financial_account_token:, request_options: {})
         #
-        # @param params [Lithic::Models::FinancialAccounts::LoanTapeRetrieveParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [String] :financial_account_token Globally unique identifier for financial account.
-        #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param loan_tape_token [String]
+        # @param financial_account_token [String]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::Models::FinancialAccounts::LoanTape]
+        #
+        # @see Lithic::Models::FinancialAccounts::LoanTapeRetrieveParams
         def retrieve(loan_tape_token, params)
           parsed, options = Lithic::Models::FinancialAccounts::LoanTapeRetrieveParams.dump_request(params)
           financial_account_token =
@@ -23,7 +23,7 @@ module Lithic
             end
           @client.request(
             method: :get,
-            path: ["v1/financial_accounts/%0s/loan_tapes/%1s", financial_account_token, loan_tape_token],
+            path: ["v1/financial_accounts/%1$s/loan_tapes/%2$s", financial_account_token, loan_tape_token],
             model: Lithic::Models::FinancialAccounts::LoanTape,
             options: options
           )
@@ -31,32 +31,24 @@ module Lithic
 
         # List the loan tapes for a given financial account.
         #
-        # @param financial_account_token [String] Globally unique identifier for financial account.
-        #
-        # @param params [Lithic::Models::FinancialAccounts::LoanTapeListParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [Date] :begin_ Date string in RFC 3339 format. Only entries created after the specified date
-        #     will be included.
-        #
-        #   @option params [Date] :end_ Date string in RFC 3339 format. Only entries created before the specified date
-        #     will be included.
+        # @overload list(financial_account_token, begin_: nil, end_: nil, ending_before: nil, page_size: nil, starting_after: nil, request_options: {})
         #
-        #   @option params [String] :ending_before A cursor representing an item's token before which a page of results should end.
-        #     Used to retrieve the previous page of results before this item.
-        #
-        #   @option params [Integer] :page_size Page size (for pagination).
-        #
-        #   @option params [String] :starting_after A cursor representing an item's token after which a page of results should
-        #     begin. Used to retrieve the next page of results after this item.
-        #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param financial_account_token [String]
+        # @param begin_ [Date]
+        # @param end_ [Date]
+        # @param ending_before [String]
+        # @param page_size [Integer]
+        # @param starting_after [String]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::CursorPage<Lithic::Models::FinancialAccounts::LoanTape>]
+        #
+        # @see Lithic::Models::FinancialAccounts::LoanTapeListParams
         def list(financial_account_token, params = {})
           parsed, options = Lithic::Models::FinancialAccounts::LoanTapeListParams.dump_request(params)
           @client.request(
             method: :get,
-            path: ["v1/financial_accounts/%0s/loan_tapes", financial_account_token],
+            path: ["v1/financial_accounts/%1$s/loan_tapes", financial_account_token],
             query: parsed,
             page: Lithic::CursorPage,
             model: Lithic::Models::FinancialAccounts::LoanTape,
@@ -64,6 +56,8 @@ module Lithic
           )
         end
 
+        # @api private
+        #
         # @param client [Lithic::Client]
         def initialize(client:)
           @client = client

data/lib/lithic/resources/financial_accounts/statements/line_items.rb

@@ -7,24 +7,18 @@ module Lithic
         class LineItems
           # List the line items for a given statement within a given financial account.
           #
-          # @param statement_token [String] Path param: Globally unique identifier for statements.
+          # @overload list(statement_token, financial_account_token:, ending_before: nil, page_size: nil, starting_after: nil, request_options: {})
           #
-          # @param params [Lithic::Models::FinancialAccounts::Statements::LineItemListParams, Hash{Symbol=>Object}] .
-          #
-          #   @option params [String] :financial_account_token Path param: Globally unique identifier for financial account.
-          #
-          #   @option params [String] :ending_before Query param: A cursor representing an item's token before which a page of
-          #     results should end. Used to retrieve the previous page of results before this
-          #     item.
-          #
-          #   @option params [Integer] :page_size Query param: Page size (for pagination).
-          #
-          #   @option params [String] :starting_after Query param: A cursor representing an item's token after which a page of results
-          #     should begin. Used to retrieve the next page of results after this item.
-          #
-          #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+          # @param statement_token [String]
+          # @param financial_account_token [String]
+          # @param ending_before [String]
+          # @param page_size [Integer]
+          # @param starting_after [String]
+          # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Lithic::CursorPage<Lithic::Models::FinancialAccounts::Statements::StatementLineItems::Data>]
+          #
+          # @see Lithic::Models::FinancialAccounts::Statements::LineItemListParams
           def list(statement_token, params)
             parsed, options = Lithic::Models::FinancialAccounts::Statements::LineItemListParams.dump_request(params)
             financial_account_token =
@@ -34,7 +28,7 @@ module Lithic
             @client.request(
               method: :get,
               path: [
-                "v1/financial_accounts/%0s/statements/%1s/line_items",
+                "v1/financial_accounts/%1$s/statements/%2$s/line_items",
                 financial_account_token,
                 statement_token
               ],
@@ -45,6 +39,8 @@ module Lithic
             )
           end
 
+          # @api private
+          #
           # @param client [Lithic::Client]
           def initialize(client:)
             @client = client

data/lib/lithic/resources/financial_accounts/statements.rb

@@ -9,15 +9,15 @@ module Lithic
 
         # Get a specific statement for a given financial account.
         #
-        # @param statement_token [String] Globally unique identifier for statements.
+        # @overload retrieve(statement_token, financial_account_token:, request_options: {})
         #
-        # @param params [Lithic::Models::FinancialAccounts::StatementRetrieveParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [String] :financial_account_token Globally unique identifier for financial account.
-        #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param statement_token [String]
+        # @param financial_account_token [String]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::Models::FinancialAccounts::Statement]
+        #
+        # @see Lithic::Models::FinancialAccounts::StatementRetrieveParams
         def retrieve(statement_token, params)
           parsed, options = Lithic::Models::FinancialAccounts::StatementRetrieveParams.dump_request(params)
           financial_account_token =
@@ -26,7 +26,7 @@ module Lithic
             end
           @client.request(
             method: :get,
-            path: ["v1/financial_accounts/%0s/statements/%1s", financial_account_token, statement_token],
+            path: ["v1/financial_accounts/%1$s/statements/%2$s", financial_account_token, statement_token],
             model: Lithic::Models::FinancialAccounts::Statement,
             options: options
           )
@@ -34,34 +34,25 @@ module Lithic
 
         # List the statements for a given financial account.
         #
-        # @param financial_account_token [String] Globally unique identifier for financial account.
-        #
-        # @param params [Lithic::Models::FinancialAccounts::StatementListParams, Hash{Symbol=>Object}] .
-        #
-        #   @option params [Date] :begin_ Date string in RFC 3339 format. Only entries created after the specified date
-        #     will be included.
-        #
-        #   @option params [Date] :end_ Date string in RFC 3339 format. Only entries created before the specified date
-        #     will be included.
+        # @overload list(financial_account_token, begin_: nil, end_: nil, ending_before: nil, include_initial_statements: nil, page_size: nil, starting_after: nil, request_options: {})
         #
-        #   @option params [String] :ending_before A cursor representing an item's token before which a page of results should end.
-        #     Used to retrieve the previous page of results before this item.
-        #
-        #   @option params [Boolean] :include_initial_statements Whether to include the initial statement. It is not included by default.
-        #
-        #   @option params [Integer] :page_size Page size (for pagination).
-        #
-        #   @option params [String] :starting_after A cursor representing an item's token after which a page of results should
-        #     begin. Used to retrieve the next page of results after this item.
-        #
-        #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+        # @param financial_account_token [String]
+        # @param begin_ [Date]
+        # @param end_ [Date]
+        # @param ending_before [String]
+        # @param include_initial_statements [Boolean]
+        # @param page_size [Integer]
+        # @param starting_after [String]
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Lithic::CursorPage<Lithic::Models::FinancialAccounts::Statement>]
+        #
+        # @see Lithic::Models::FinancialAccounts::StatementListParams
         def list(financial_account_token, params = {})
           parsed, options = Lithic::Models::FinancialAccounts::StatementListParams.dump_request(params)
           @client.request(
             method: :get,
-            path: ["v1/financial_accounts/%0s/statements", financial_account_token],
+            path: ["v1/financial_accounts/%1$s/statements", financial_account_token],
             query: parsed,
             page: Lithic::CursorPage,
             model: Lithic::Models::FinancialAccounts::Statement,
@@ -69,6 +60,8 @@ module Lithic
           )
         end
 
+        # @api private
+        #
         # @param client [Lithic::Client]
         def initialize(client:)
           @client = client

data/lib/lithic/resources/financial_accounts.rb

@@ -20,21 +20,18 @@ module Lithic
 
       # Create a new financial account
       #
-      # @param params [Lithic::Models::FinancialAccountCreateParams, Hash{Symbol=>Object}] .
+      # @overload create(nickname:, type:, account_token: nil, is_for_benefit_of: nil, idempotency_key: nil, request_options: {})
       #
-      #   @option params [String] :nickname Body param:
-      #
-      #   @option params [Symbol, Lithic::Models::FinancialAccountCreateParams::Type] :type Body param:
-      #
-      #   @option params [String] :account_token Body param:
-      #
-      #   @option params [Boolean] :is_for_benefit_of Body param:
-      #
-      #   @option params [String] :idempotency_key Header param:
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param nickname [String]
+      # @param type [Symbol, Lithic::Models::FinancialAccountCreateParams::Type]
+      # @param account_token [String]
+      # @param is_for_benefit_of [Boolean]
+      # @param idempotency_key [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::FinancialAccount]
+      #
+      # @see Lithic::Models::FinancialAccountCreateParams
       def create(params)
         parsed, options = Lithic::Models::FinancialAccountCreateParams.dump_request(params)
         header_params = [:"Idempotency-Key"]
@@ -50,17 +47,18 @@ module Lithic
 
       # Get a financial account
       #
-      # @param financial_account_token [String]
+      # @overload retrieve(financial_account_token, request_options: {})
       #
-      # @param params [Lithic::Models::FinancialAccountRetrieveParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param financial_account_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::FinancialAccount]
+      #
+      # @see Lithic::Models::FinancialAccountRetrieveParams
       def retrieve(financial_account_token, params = {})
         @client.request(
           method: :get,
-          path: ["v1/financial_accounts/%0s", financial_account_token],
+          path: ["v1/financial_accounts/%1$s", financial_account_token],
           model: Lithic::Models::FinancialAccount,
           options: params[:request_options]
         )
@@ -68,20 +66,20 @@ module Lithic
 
       # Update a financial account
       #
-      # @param financial_account_token [String]
-      #
-      # @param params [Lithic::Models::FinancialAccountUpdateParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :nickname
+      # @overload update(financial_account_token, nickname: nil, request_options: {})
       #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param financial_account_token [String]
+      # @param nickname [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::FinancialAccount]
+      #
+      # @see Lithic::Models::FinancialAccountUpdateParams
       def update(financial_account_token, params = {})
         parsed, options = Lithic::Models::FinancialAccountUpdateParams.dump_request(params)
         @client.request(
           method: :patch,
-          path: ["v1/financial_accounts/%0s", financial_account_token],
+          path: ["v1/financial_accounts/%1$s", financial_account_token],
           body: parsed,
           model: Lithic::Models::FinancialAccount,
           options: options
@@ -91,17 +89,16 @@ module Lithic
       # Retrieve information on your financial accounts including routing and account
       #   number.
       #
-      # @param params [Lithic::Models::FinancialAccountListParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [String] :account_token List financial accounts for a given account_token or business_account_token
+      # @overload list(account_token: nil, business_account_token: nil, type: nil, request_options: {})
       #
-      #   @option params [String] :business_account_token List financial accounts for a given business_account_token
-      #
-      #   @option params [Symbol, Lithic::Models::FinancialAccountListParams::Type] :type List financial accounts of a given type
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param account_token [String]
+      # @param business_account_token [String]
+      # @param type [Symbol, Lithic::Models::FinancialAccountListParams::Type]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::SinglePage<Lithic::Models::FinancialAccount>]
+      #
+      # @see Lithic::Models::FinancialAccountListParams
       def list(params = {})
         parsed, options = Lithic::Models::FinancialAccountListParams.dump_request(params)
         @client.request(
@@ -116,28 +113,29 @@ module Lithic
 
       # Update financial account status
       #
-      # @param financial_account_token [String] Globally unique identifier for financial account.
+      # @overload update_status(financial_account_token, status:, status_change_reason:, request_options: {})
       #
-      # @param params [Lithic::Models::FinancialAccountUpdateStatusParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Symbol, Lithic::Models::FinancialAccountUpdateStatusParams::Status] :status Status of the financial account
-      #
-      #   @option params [Symbol, Lithic::Models::FinancialAccountUpdateStatusParams::StatusChangeReason, nil] :status_change_reason Reason for the financial account status change
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param financial_account_token [String]
+      # @param status [Symbol, Lithic::Models::FinancialAccountUpdateStatusParams::Status]
+      # @param status_change_reason [Symbol, Lithic::Models::FinancialAccountUpdateStatusParams::StatusChangeReason, nil]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::FinancialAccount]
+      #
+      # @see Lithic::Models::FinancialAccountUpdateStatusParams
       def update_status(financial_account_token, params)
         parsed, options = Lithic::Models::FinancialAccountUpdateStatusParams.dump_request(params)
         @client.request(
           method: :post,
-          path: ["v1/financial_accounts/%0s/update_status", financial_account_token],
+          path: ["v1/financial_accounts/%1$s/update_status", financial_account_token],
           body: parsed,
           model: Lithic::Models::FinancialAccount,
           options: options
         )
       end
 
+      # @api private
+      #
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client

data/lib/lithic/resources/management_operations.rb

@@ -5,31 +5,23 @@ module Lithic
     class ManagementOperations
       # Create management operation
       #
-      # @param params [Lithic::Models::ManagementOperationCreateParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Integer] :amount
-      #
-      #   @option params [Symbol, Lithic::Models::ManagementOperationCreateParams::Category] :category
-      #
-      #   @option params [Symbol, Lithic::Models::ManagementOperationCreateParams::Direction] :direction
-      #
-      #   @option params [Date] :effective_date
-      #
-      #   @option params [Symbol, Lithic::Models::ManagementOperationCreateParams::EventType] :event_type
-      #
-      #   @option params [String] :financial_account_token
-      #
-      #   @option params [String] :token
-      #
-      #   @option params [String] :memo
-      #
-      #   @option params [String] :subtype
-      #
-      #   @option params [String] :user_defined_id
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @overload create(amount:, category:, direction:, effective_date:, event_type:, financial_account_token:, token: nil, memo: nil, subtype: nil, user_defined_id: nil, request_options: {})
+      #
+      # @param amount [Integer]
+      # @param category [Symbol, Lithic::Models::ManagementOperationCreateParams::Category]
+      # @param direction [Symbol, Lithic::Models::ManagementOperationCreateParams::Direction]
+      # @param effective_date [Date]
+      # @param event_type [Symbol, Lithic::Models::ManagementOperationCreateParams::EventType]
+      # @param financial_account_token [String]
+      # @param token [String]
+      # @param memo [String]
+      # @param subtype [String]
+      # @param user_defined_id [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::ManagementOperationTransaction]
+      #
+      # @see Lithic::Models::ManagementOperationCreateParams
       def create(params)
         parsed, options = Lithic::Models::ManagementOperationCreateParams.dump_request(params)
         @client.request(
@@ -43,17 +35,18 @@ module Lithic
 
       # Get management operation
       #
-      # @param management_operation_token [String] Globally unique identifier for the management operation
+      # @overload retrieve(management_operation_token, request_options: {})
       #
-      # @param params [Lithic::Models::ManagementOperationRetrieveParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param management_operation_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::ManagementOperationTransaction]
+      #
+      # @see Lithic::Models::ManagementOperationRetrieveParams
       def retrieve(management_operation_token, params = {})
         @client.request(
           method: :get,
-          path: ["v1/management_operations/%0s", management_operation_token],
+          path: ["v1/management_operations/%1$s", management_operation_token],
           model: Lithic::Models::ManagementOperationTransaction,
           options: params[:request_options]
         )
@@ -61,34 +54,22 @@ module Lithic
 
       # List management operations
       #
-      # @param params [Lithic::Models::ManagementOperationListParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Time] :begin_ Date string in RFC 3339 format. Only entries created after the specified time
-      #     will be included. UTC time zone.
+      # @overload list(begin_: nil, business_account_token: nil, category: nil, end_: nil, ending_before: nil, financial_account_token: nil, page_size: nil, starting_after: nil, status: nil, request_options: {})
       #
-      #   @option params [String] :business_account_token
-      #
-      #   @option params [Symbol, Lithic::Models::ManagementOperationListParams::Category] :category Management operation category to be returned.
-      #
-      #   @option params [Time] :end_ Date string in RFC 3339 format. Only entries created before the specified time
-      #     will be included. UTC time zone.
-      #
-      #   @option params [String] :ending_before A cursor representing an item's token before which a page of results should end.
-      #     Used to retrieve the previous page of results before this item.
-      #
-      #   @option params [String] :financial_account_token Globally unique identifier for the financial account. Accepted type dependent on
-      #     the program's use case.
-      #
-      #   @option params [Integer] :page_size Page size (for pagination).
-      #
-      #   @option params [String] :starting_after A cursor representing an item's token after which a page of results should
-      #     begin. Used to retrieve the next page of results after this item.
-      #
-      #   @option params [Symbol, Lithic::Models::ManagementOperationListParams::Status] :status Management operation status to be returned.
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param begin_ [Time]
+      # @param business_account_token [String]
+      # @param category [Symbol, Lithic::Models::ManagementOperationListParams::Category]
+      # @param end_ [Time]
+      # @param ending_before [String]
+      # @param financial_account_token [String]
+      # @param page_size [Integer]
+      # @param starting_after [String]
+      # @param status [Symbol, Lithic::Models::ManagementOperationListParams::Status]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::CursorPage<Lithic::Models::ManagementOperationTransaction>]
+      #
+      # @see Lithic::Models::ManagementOperationListParams
       def list(params = {})
         parsed, options = Lithic::Models::ManagementOperationListParams.dump_request(params)
         @client.request(
@@ -103,28 +84,29 @@ module Lithic
 
       # Reverse a management operation
       #
-      # @param management_operation_token [String] Globally unique identifier for the management operation
-      #
-      # @param params [Lithic::Models::ManagementOperationReverseParams, Hash{Symbol=>Object}] .
-      #
-      #   @option params [Date] :effective_date
+      # @overload reverse(management_operation_token, effective_date:, memo: nil, request_options: {})
       #
-      #   @option params [String] :memo
-      #
-      #   @option params [Lithic::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      # @param management_operation_token [String]
+      # @param effective_date [Date]
+      # @param memo [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::ManagementOperationTransaction]
+      #
+      # @see Lithic::Models::ManagementOperationReverseParams
       def reverse(management_operation_token, params)
         parsed, options = Lithic::Models::ManagementOperationReverseParams.dump_request(params)
         @client.request(
           method: :post,
-          path: ["v1/management_operations/%0s/reverse", management_operation_token],
+          path: ["v1/management_operations/%1$s/reverse", management_operation_token],
           body: parsed,
           model: Lithic::Models::ManagementOperationTransaction,
           options: options
         )
       end
 
+      # @api private
+      #
       # @param client [Lithic::Client]
       def initialize(client:)
         @client = client