finch-api 0.1.0.pre.alpha.30 → 0.1.0.pre.alpha.31

data/lib/finch_api/resources/hris/company/pay_statement_item/rules.rb

@@ -6,6 +6,10 @@ module FinchAPI
       class Company
         class PayStatementItem
           class Rules
+            # Some parameter documentations has been truncated, see
+            # {FinchAPI::Models::HRIS::Company::PayStatementItem::RuleCreateParams} for more
+            # details.
+            #
             # **Beta:** this endpoint currently serves employers onboarded after March 4th and
             # historical support will be added soon Custom rules can be created to associate
             # specific attributes to pay statement items depending on the use case. For
@@ -13,17 +17,19 @@ module FinchAPI
             # pre-tax 401k. This metadata can be retrieved where pay statement item
             # information is available.
             #
-            # @overload create(attributes: nil, conditions: nil, effective_end_date: nil, effective_start_date: nil, entity_type: nil, request_options: {})
+            # @overload create(entity_ids: nil, attributes: nil, conditions: nil, effective_end_date: nil, effective_start_date: nil, entity_type: nil, request_options: {})
+            #
+            # @param entity_ids [Array<String>] Query param: The entity IDs to create the rule for.
             #
-            # @param attributes [FinchAPI::Models::HRIS::Company::PayStatementItem::RuleCreateParams::Attributes] Specifies the fields to be applied when the condition is met.
+            # @param attributes [FinchAPI::Models::HRIS::Company::PayStatementItem::RuleCreateParams::Attributes] Body param: Specifies the fields to be applied when the condition is met.
             #
-            # @param conditions [Array<FinchAPI::Models::HRIS::Company::PayStatementItem::RuleCreateParams::Condition>]
+            # @param conditions [Array<FinchAPI::Models::HRIS::Company::PayStatementItem::RuleCreateParams::Condition>] Body param:
             #
-            # @param effective_end_date [String, nil] Specifies when the rules should stop applying rules based on the date.
+            # @param effective_end_date [String, nil] Body param: Specifies when the rules should stop applying rules based on the dat
             #
-            # @param effective_start_date [String, nil] Specifies when the rule should begin applying based on the date.
+            # @param effective_start_date [String, nil] Body param: Specifies when the rule should begin applying based on the date.
             #
-            # @param entity_type [Symbol, FinchAPI::Models::HRIS::Company::PayStatementItem::RuleCreateParams::EntityType] The entity type to which the rule is applied.
+            # @param entity_type [Symbol, FinchAPI::Models::HRIS::Company::PayStatementItem::RuleCreateParams::EntityType] Body param: The entity type to which the rule is applied.
             #
             # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -32,10 +38,12 @@ module FinchAPI
             # @see FinchAPI::Models::HRIS::Company::PayStatementItem::RuleCreateParams
             def create(params = {})
               parsed, options = FinchAPI::HRIS::Company::PayStatementItem::RuleCreateParams.dump_request(params)
+              query_params = [:entity_ids]
               @client.request(
                 method: :post,
                 path: "employer/pay-statement-item/rule",
-                body: parsed,
+                query: parsed.slice(*query_params),
+                body: parsed.except(*query_params),
                 model: FinchAPI::Models::HRIS::Company::PayStatementItem::RuleCreateResponse,
                 options: options
               )
@@ -44,10 +52,14 @@ module FinchAPI
             # **Beta:** this endpoint currently serves employers onboarded after March 4th and
             # historical support will be added soon Update a rule for a pay statement item.
             #
-            # @overload update(rule_id, optional_property: nil, request_options: {})
+            # @overload update(rule_id, entity_ids: nil, optional_property: nil, request_options: {})
+            #
+            # @param rule_id [String] Path param:
+            #
+            # @param entity_ids [Array<String>] Query param: The entity IDs to update the rule for.
+            #
+            # @param optional_property [Object] Body param:
             #
-            # @param rule_id [String]
-            # @param optional_property [Object]
             # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
             # @return [FinchAPI::Models::HRIS::Company::PayStatementItem::RuleUpdateResponse]
@@ -55,10 +67,12 @@ module FinchAPI
             # @see FinchAPI::Models::HRIS::Company::PayStatementItem::RuleUpdateParams
             def update(rule_id, params = {})
               parsed, options = FinchAPI::HRIS::Company::PayStatementItem::RuleUpdateParams.dump_request(params)
+              query_params = [:entity_ids]
               @client.request(
                 method: :put,
                 path: ["employer/pay-statement-item/rule/%1$s", rule_id],
-                body: parsed,
+                query: parsed.slice(*query_params),
+                body: parsed.except(*query_params),
                 model: FinchAPI::Models::HRIS::Company::PayStatementItem::RuleUpdateResponse,
                 options: options
               )
@@ -67,7 +81,9 @@ module FinchAPI
             # **Beta:** this endpoint currently serves employers onboarded after March 4th and
             # historical support will be added soon List all rules of a connection account.
             #
-            # @overload list(request_options: {})
+            # @overload list(entity_ids: nil, request_options: {})
+            #
+            # @param entity_ids [Array<String>] The entity IDs to retrieve rules for.
             #
             # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
@@ -75,32 +91,39 @@ module FinchAPI
             #
             # @see FinchAPI::Models::HRIS::Company::PayStatementItem::RuleListParams
             def list(params = {})
+              parsed, options = FinchAPI::HRIS::Company::PayStatementItem::RuleListParams.dump_request(params)
               @client.request(
                 method: :get,
                 path: "employer/pay-statement-item/rule",
+                query: parsed,
                 page: FinchAPI::Internal::ResponsesPage,
                 model: FinchAPI::Models::HRIS::Company::PayStatementItem::RuleListResponse,
-                options: params[:request_options]
+                options: options
               )
             end
 
             # **Beta:** this endpoint currently serves employers onboarded after March 4th and
             # historical support will be added soon Delete a rule for a pay statement item.
             #
-            # @overload delete(rule_id, request_options: {})
+            # @overload delete(rule_id, entity_ids: nil, request_options: {})
             #
             # @param rule_id [String]
+            #
+            # @param entity_ids [Array<String>] The entity IDs to delete the rule for.
+            #
             # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
             # @return [FinchAPI::Models::HRIS::Company::PayStatementItem::RuleDeleteResponse]
             #
             # @see FinchAPI::Models::HRIS::Company::PayStatementItem::RuleDeleteParams
             def delete(rule_id, params = {})
+              parsed, options = FinchAPI::HRIS::Company::PayStatementItem::RuleDeleteParams.dump_request(params)
               @client.request(
                 method: :delete,
                 path: ["employer/pay-statement-item/rule/%1$s", rule_id],
+                query: parsed,
                 model: FinchAPI::Models::HRIS::Company::PayStatementItem::RuleDeleteResponse,
-                options: params[:request_options]
+                options: options
               )
             end
 

data/lib/finch_api/resources/hris/company/pay_statement_item.rb

@@ -15,12 +15,14 @@ module FinchAPI
           # historical support will be added soon Retrieve a list of detailed pay statement
           # items for the access token's connection account.
           #
-          # @overload list(categories: nil, end_date: nil, name: nil, start_date: nil, type: nil, request_options: {})
+          # @overload list(categories: nil, end_date: nil, entity_ids: nil, name: nil, start_date: nil, type: nil, request_options: {})
           #
           # @param categories [Array<Symbol, FinchAPI::Models::HRIS::Company::PayStatementItemListParams::Category>] Comma-delimited list of pay statement item categories to filter on. If empty, de
           #
           # @param end_date [Date] The end date to retrieve pay statement items by via their last seen pay date in
           #
+          # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
+          #
           # @param name [String] Case-insensitive partial match search by pay statement item name.
           #
           # @param start_date [Date] The start date to retrieve pay statement items by via their last seen pay date (

data/lib/finch_api/resources/hris/company.rb

@@ -9,7 +9,9 @@ module FinchAPI
 
         # Read basic company data
         #
-        # @overload retrieve(request_options: {})
+        # @overload retrieve(entity_ids: nil, request_options: {})
+        #
+        # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
         #
         # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -17,11 +19,13 @@ module FinchAPI
         #
         # @see FinchAPI::Models::HRIS::CompanyRetrieveParams
         def retrieve(params = {})
+          parsed, options = FinchAPI::HRIS::CompanyRetrieveParams.dump_request(params)
           @client.request(
             method: :get,
             path: "employer/company",
+            query: parsed,
             model: FinchAPI::HRIS::HRISCompany,
-            options: params[:request_options]
+            options: options
           )
         end
 

data/lib/finch_api/resources/hris/directory.rb

@@ -6,7 +6,9 @@ module FinchAPI
       class Directory
         # Read company directory and organization structure
         #
-        # @overload list(limit: nil, offset: nil, request_options: {})
+        # @overload list(entity_ids: nil, limit: nil, offset: nil, request_options: {})
+        #
+        # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
         #
         # @param limit [Integer] Number of employees to return (defaults to all)
         #

data/lib/finch_api/resources/hris/documents.rb

@@ -10,7 +10,9 @@ module FinchAPI
         # **Beta:** This endpoint is in beta and may change. Retrieve a list of
         # company-wide documents.
         #
-        # @overload list(individual_ids: nil, limit: nil, offset: nil, types: nil, request_options: {})
+        # @overload list(entity_ids: nil, individual_ids: nil, limit: nil, offset: nil, types: nil, request_options: {})
+        #
+        # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
         #
         # @param individual_ids [Array<String>] Comma-delimited list of stable Finch uuids for each individual. If empty, defaul
         #
@@ -39,21 +41,25 @@ module FinchAPI
         # **Beta:** This endpoint is in beta and may change. Retrieve details of a
         # specific document by its ID.
         #
-        # @overload retreive(document_id, request_options: {})
+        # @overload retreive(document_id, entity_ids: nil, request_options: {})
         #
         # @param document_id [String] The unique identifier of the document.
         #
+        # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
+        #
         # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [FinchAPI::Models::HRIS::W42020, FinchAPI::Models::HRIS::W42005]
         #
         # @see FinchAPI::Models::HRIS::DocumentRetreiveParams
         def retreive(document_id, params = {})
+          parsed, options = FinchAPI::HRIS::DocumentRetreiveParams.dump_request(params)
           @client.request(
             method: :get,
             path: ["employer/documents/%1$s", document_id],
+            query: parsed,
             model: FinchAPI::Models::HRIS::DocumentRetreiveResponse,
-            options: params[:request_options]
+            options: options
           )
         end
 

data/lib/finch_api/resources/hris/employments.rb

@@ -6,9 +6,11 @@ module FinchAPI
       class Employments
         # Read individual employment and income data
         #
-        # @overload retrieve_many(requests:, request_options: {})
+        # @overload retrieve_many(requests:, entity_ids: nil, request_options: {})
         #
-        # @param requests [Array<FinchAPI::Models::HRIS::EmploymentRetrieveManyParams::Request>] The array of batch requests.
+        # @param requests [Array<FinchAPI::Models::HRIS::EmploymentRetrieveManyParams::Request>] Body param: The array of batch requests.
+        #
+        # @param entity_ids [Array<String>] Query param: The entity IDs to specify which entities' data to access.
         #
         # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -17,10 +19,12 @@ module FinchAPI
         # @see FinchAPI::Models::HRIS::EmploymentRetrieveManyParams
         def retrieve_many(params)
           parsed, options = FinchAPI::HRIS::EmploymentRetrieveManyParams.dump_request(params)
+          query_params = [:entity_ids]
           @client.request(
             method: :post,
             path: "employer/employment",
-            body: parsed,
+            query: parsed.slice(*query_params),
+            body: parsed.except(*query_params),
             page: FinchAPI::Internal::ResponsesPage,
             model: FinchAPI::HRIS::EmploymentDataResponse,
             options: options

data/lib/finch_api/resources/hris/individuals.rb

@@ -6,10 +6,14 @@ module FinchAPI
       class Individuals
         # Read individual data, excluding income and employment data
         #
-        # @overload retrieve_many(options: nil, requests: nil, request_options: {})
+        # @overload retrieve_many(entity_ids: nil, options: nil, requests: nil, request_options: {})
+        #
+        # @param entity_ids [Array<String>] Query param: The entity IDs to specify which entities' data to access.
+        #
+        # @param options [FinchAPI::Models::HRIS::IndividualRetrieveManyParams::Options, nil] Body param:
+        #
+        # @param requests [Array<FinchAPI::Models::HRIS::IndividualRetrieveManyParams::Request>] Body param:
         #
-        # @param options [FinchAPI::Models::HRIS::IndividualRetrieveManyParams::Options, nil]
-        # @param requests [Array<FinchAPI::Models::HRIS::IndividualRetrieveManyParams::Request>]
         # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [FinchAPI::Internal::ResponsesPage<FinchAPI::Models::HRIS::IndividualResponse>]
@@ -17,10 +21,12 @@ module FinchAPI
         # @see FinchAPI::Models::HRIS::IndividualRetrieveManyParams
         def retrieve_many(params = {})
           parsed, options = FinchAPI::HRIS::IndividualRetrieveManyParams.dump_request(params)
+          query_params = [:entity_ids]
           @client.request(
             method: :post,
             path: "employer/individual",
-            body: parsed,
+            query: parsed.slice(*query_params),
+            body: parsed.except(*query_params),
             page: FinchAPI::Internal::ResponsesPage,
             model: FinchAPI::HRIS::IndividualResponse,
             options: options

data/lib/finch_api/resources/hris/pay_statements.rb

@@ -9,9 +9,11 @@ module FinchAPI
         # Deduction and contribution types are supported by the payroll systems that
         # supports Benefits.
         #
-        # @overload retrieve_many(requests:, request_options: {})
+        # @overload retrieve_many(requests:, entity_ids: nil, request_options: {})
         #
-        # @param requests [Array<FinchAPI::Models::HRIS::PayStatementRetrieveManyParams::Request>] The array of batch requests.
+        # @param requests [Array<FinchAPI::Models::HRIS::PayStatementRetrieveManyParams::Request>] Body param: The array of batch requests.
+        #
+        # @param entity_ids [Array<String>] Query param: The entity IDs to specify which entities' data to access.
         #
         # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -20,10 +22,12 @@ module FinchAPI
         # @see FinchAPI::Models::HRIS::PayStatementRetrieveManyParams
         def retrieve_many(params)
           parsed, options = FinchAPI::HRIS::PayStatementRetrieveManyParams.dump_request(params)
+          query_params = [:entity_ids]
           @client.request(
             method: :post,
             path: "employer/pay-statement",
-            body: parsed,
+            query: parsed.slice(*query_params),
+            body: parsed.except(*query_params),
             page: FinchAPI::Internal::ResponsesPage,
             model: FinchAPI::HRIS::PayStatementResponse,
             options: options

data/lib/finch_api/resources/hris/payments.rb

@@ -9,12 +9,14 @@ module FinchAPI
         #
         # Read payroll and contractor related payments by the company.
         #
-        # @overload list(end_date:, start_date:, request_options: {})
+        # @overload list(end_date:, start_date:, entity_ids: nil, request_options: {})
         #
         # @param end_date [Date] The end date to retrieve payments by a company (inclusive) in `YYYY-MM-DD` forma
         #
         # @param start_date [Date] The start date to retrieve payments by a company (inclusive) in `YYYY-MM-DD` for
         #
+        # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
+        #
         # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [FinchAPI::Internal::SinglePage<FinchAPI::Models::HRIS::Payment>]

data/lib/finch_api/resources/jobs/automated.rb

@@ -41,43 +41,30 @@ module FinchAPI
           )
         end
 
-        # Some parameter documentations has been truncated, see
-        # {FinchAPI::Models::Jobs::AutomatedRetrieveParams} for more details.
-        #
         # Get an automated job by `job_id`.
         #
-        # @overload retrieve(job_id, entity_id: nil, request_options: {})
+        # @overload retrieve(job_id, request_options: {})
         #
         # @param job_id [String]
-        #
-        # @param entity_id [String] The entity ID to use when authenticating with a multi-account token. Required wh
-        #
         # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [FinchAPI::Models::Jobs::AutomatedAsyncJob]
         #
         # @see FinchAPI::Models::Jobs::AutomatedRetrieveParams
         def retrieve(job_id, params = {})
-          parsed, options = FinchAPI::Jobs::AutomatedRetrieveParams.dump_request(params)
           @client.request(
             method: :get,
             path: ["jobs/automated/%1$s", job_id],
-            query: parsed,
             model: FinchAPI::Jobs::AutomatedAsyncJob,
-            options: options
+            options: params[:request_options]
           )
         end
 
-        # Some parameter documentations has been truncated, see
-        # {FinchAPI::Models::Jobs::AutomatedListParams} for more details.
-        #
         # Get all automated jobs. Automated jobs are completed by a machine. By default,
         # jobs are sorted in descending order by submission time. For scheduled jobs such
         # as data syncs, only the next scheduled job is shown.
         #
-        # @overload list(entity_id: nil, limit: nil, offset: nil, request_options: {})
-        #
-        # @param entity_id [String] The entity ID to use when authenticating with a multi-account token. Required wh
+        # @overload list(limit: nil, offset: nil, request_options: {})
         #
         # @param limit [Integer] Number of items to return
         #

data/lib/finch_api/resources/jobs/manual.rb

@@ -4,31 +4,23 @@ module FinchAPI
   module Resources
     class Jobs
       class Manual
-        # Some parameter documentations has been truncated, see
-        # {FinchAPI::Models::Jobs::ManualRetrieveParams} for more details.
-        #
         # Get a manual job by `job_id`. Manual jobs are completed by a human and include
         # Assisted Benefits jobs.
         #
-        # @overload retrieve(job_id, entity_id: nil, request_options: {})
+        # @overload retrieve(job_id, request_options: {})
         #
         # @param job_id [String]
-        #
-        # @param entity_id [String] The entity ID to use when authenticating with a multi-account token. Required wh
-        #
         # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [FinchAPI::Models::Jobs::ManualAsyncJob]
         #
         # @see FinchAPI::Models::Jobs::ManualRetrieveParams
         def retrieve(job_id, params = {})
-          parsed, options = FinchAPI::Jobs::ManualRetrieveParams.dump_request(params)
           @client.request(
             method: :get,
             path: ["jobs/manual/%1$s", job_id],
-            query: parsed,
             model: FinchAPI::Jobs::ManualAsyncJob,
-            options: options
+            options: params[:request_options]
           )
         end
 

data/lib/finch_api/resources/payroll/pay_groups.rb

@@ -6,29 +6,38 @@ module FinchAPI
       class PayGroups
         # Read information from a single pay group
         #
-        # @overload retrieve(pay_group_id, request_options: {})
+        # @overload retrieve(pay_group_id, entity_ids: nil, request_options: {})
         #
         # @param pay_group_id [String]
+        #
+        # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
+        #
         # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [FinchAPI::Models::Payroll::PayGroupRetrieveResponse]
         #
         # @see FinchAPI::Models::Payroll::PayGroupRetrieveParams
         def retrieve(pay_group_id, params = {})
+          parsed, options = FinchAPI::Payroll::PayGroupRetrieveParams.dump_request(params)
           @client.request(
             method: :get,
             path: ["employer/pay-groups/%1$s", pay_group_id],
+            query: parsed,
             model: FinchAPI::Models::Payroll::PayGroupRetrieveResponse,
-            options: params[:request_options]
+            options: options
           )
         end
 
         # Read company pay groups and frequencies
         #
-        # @overload list(individual_id: nil, pay_frequencies: nil, request_options: {})
+        # @overload list(entity_ids: nil, individual_id: nil, pay_frequencies: nil, request_options: {})
+        #
+        # @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
         #
         # @param individual_id [String]
+        #
         # @param pay_frequencies [Array<String>]
+        #
         # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [FinchAPI::Internal::SinglePage<FinchAPI::Models::Payroll::PayGroupListResponse>]

data/lib/finch_api/resources/providers.rb

@@ -9,7 +9,7 @@ module FinchAPI
       #
       # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [FinchAPI::Internal::SinglePage<FinchAPI::Models::Provider>]
+      # @return [FinchAPI::Internal::SinglePage<FinchAPI::Models::ProviderListResponse>]
       #
       # @see FinchAPI::Models::ProviderListParams
       def list(params = {})
@@ -17,7 +17,7 @@ module FinchAPI
           method: :get,
           path: "providers",
           page: FinchAPI::Internal::SinglePage,
-          model: FinchAPI::Provider,
+          model: FinchAPI::Models::ProviderListResponse,
           options: params[:request_options]
         )
       end

data/lib/finch_api/resources/request_forwarding.rb

@@ -19,9 +19,9 @@ module FinchAPI
       #
       # @param data [String, nil] The body for the forwarded request. This value must be specified as either a str
       #
-      # @param headers [Object, nil] The HTTP headers to include on the forwarded request. This value must be specifi
+      # @param headers [Hash{Symbol=>Object, nil}, nil] The HTTP headers to include on the forwarded request. This value must be specifi
       #
-      # @param params [Object, nil] The query parameters for the forwarded request. This value must be specified as
+      # @param params [Hash{Symbol=>Object, nil}, nil] The query parameters for the forwarded request. This value must be specified as
       #
       # @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/finch_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FinchAPI
-  VERSION = "0.1.0.pre.alpha.30"
+  VERSION = "0.1.0.pre.alpha.31"
 end

data/lib/finch_api.rb

@@ -154,6 +154,7 @@ require_relative "finch_api/models/payroll/pay_group_retrieve_response"
 require_relative "finch_api/models/pay_statement_event"
 require_relative "finch_api/models/provider"
 require_relative "finch_api/models/provider_list_params"
+require_relative "finch_api/models/provider_list_response"
 require_relative "finch_api/models/request_forwarding_forward_params"
 require_relative "finch_api/models/request_forwarding_forward_response"
 require_relative "finch_api/models/sandbox/company_update_params"

data/rbi/finch_api/errors.rbi

@@ -33,6 +33,9 @@ module FinchAPI
       sig { returns(T.nilable(Integer)) }
       attr_accessor :status
 
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_accessor :headers
+
       sig { returns(T.nilable(T.anything)) }
       attr_accessor :body
 
@@ -41,6 +44,7 @@ module FinchAPI
         params(
           url: URI::Generic,
           status: T.nilable(Integer),
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
@@ -50,6 +54,7 @@ module FinchAPI
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -70,6 +75,7 @@ module FinchAPI
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -79,6 +85,7 @@ module FinchAPI
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -93,6 +100,7 @@ module FinchAPI
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -102,6 +110,7 @@ module FinchAPI
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,13 +125,22 @@ module FinchAPI
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.for(url:, status:, body:, request:, response:, message: nil)
+      def self.for(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
 
       sig { returns(Integer) }
@@ -133,13 +151,22 @@ module FinchAPI
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.new(url:, status:, body:, request:, response:, message: nil)
+      def self.new(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
     end
 

data/rbi/finch_api/file_part.rbi

@@ -27,7 +27,7 @@ module FinchAPI
     sig do
       params(
         content: T.any(Pathname, StringIO, IO, String),
-        filename: T.nilable(String),
+        filename: T.nilable(T.any(Pathname, String)),
         content_type: T.nilable(String)
       ).returns(T.attached_class)
     end

data/rbi/finch_api/internal/transport/base_client.rbi

@@ -84,10 +84,9 @@ module FinchAPI
 
           # @api private
           sig do
-            params(
-              status: Integer,
-              headers: T.any(T::Hash[String, String], Net::HTTPHeader)
-            ).returns(T::Boolean)
+            params(status: Integer, headers: T::Hash[String, String]).returns(
+              T::Boolean
+            )
           end
           def should_retry?(status, headers:)
           end
@@ -97,7 +96,7 @@ module FinchAPI
             params(
               request: FinchAPI::Internal::Transport::BaseClient::RequestInput,
               status: Integer,
-              response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+              response_headers: T::Hash[String, String]
             ).returns(FinchAPI::Internal::Transport::BaseClient::RequestInput)
           end
           def follow_redirect(request, status:, response_headers:)

data/rbi/finch_api/internal/type/base_page.rbi

@@ -30,7 +30,7 @@ module FinchAPI
           params(
             client: FinchAPI::Internal::Transport::BaseClient,
             req: FinchAPI::Internal::Transport::BaseClient::RequestComponents,
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             page_data: T.anything
           ).void
         end