finch-api 0.1.0.pre.alpha.48 → 0.1.0.pre.alpha.50

data/rbi/finch_api/models/hris/benefit_retrieve_params.rbi

@@ -18,7 +18,8 @@ module FinchAPI
         sig { returns(String) }
         attr_accessor :benefit_id
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -34,7 +35,8 @@ module FinchAPI
         end
         def self.new(
           benefit_id:,
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           request_options: {}
         )

data/rbi/finch_api/models/hris/benefit_update_params.rbi

@@ -18,7 +18,8 @@ module FinchAPI
         sig { returns(String) }
         attr_accessor :benefit_id
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -42,7 +43,8 @@ module FinchAPI
         end
         def self.new(
           benefit_id:,
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           # Updated name or description.
           description: nil,

data/rbi/finch_api/models/hris/benefits/individual_enroll_many_params.rbi

@@ -19,7 +19,8 @@ module FinchAPI
           sig { returns(String) }
           attr_accessor :benefit_id
 
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :entity_ids
 
@@ -61,7 +62,8 @@ module FinchAPI
           end
           def self.new(
             benefit_id:,
-            # The entity IDs to specify which entities' data to access.
+            # The entity IDs to specify which entities' data to access. Provide exactly one
+            # entity ID per request; a maximum of one is accepted.
             entity_ids: nil,
             # Array of the individual_id to enroll and a configuration object.
             individuals: nil,

data/rbi/finch_api/models/hris/benefits/individual_enrolled_ids_params.rbi

@@ -19,7 +19,8 @@ module FinchAPI
           sig { returns(String) }
           attr_accessor :benefit_id
 
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :entity_ids
 
@@ -35,7 +36,8 @@ module FinchAPI
           end
           def self.new(
             benefit_id:,
-            # The entity IDs to specify which entities' data to access.
+            # The entity IDs to specify which entities' data to access. Provide exactly one
+            # entity ID per request; a maximum of one is accepted.
             entity_ids: nil,
             request_options: {}
           )

data/rbi/finch_api/models/hris/benefits/individual_retrieve_many_benefits_params.rbi

@@ -19,7 +19,8 @@ module FinchAPI
           sig { returns(String) }
           attr_accessor :benefit_id
 
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :entity_ids
 
@@ -44,7 +45,8 @@ module FinchAPI
           end
           def self.new(
             benefit_id:,
-            # The entity IDs to specify which entities' data to access.
+            # The entity IDs to specify which entities' data to access. Provide exactly one
+            # entity ID per request; a maximum of one is accepted.
             entity_ids: nil,
             # comma-delimited list of stable Finch uuids for each individual. If empty,
             # defaults to all individuals

data/rbi/finch_api/models/hris/benefits/individual_unenroll_many_params.rbi

@@ -19,7 +19,8 @@ module FinchAPI
           sig { returns(String) }
           attr_accessor :benefit_id
 
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :entity_ids
 
@@ -43,7 +44,8 @@ module FinchAPI
           end
           def self.new(
             benefit_id:,
-            # The entity IDs to specify which entities' data to access.
+            # The entity IDs to specify which entities' data to access. Provide exactly one
+            # entity ID per request; a maximum of one is accepted.
             entity_ids: nil,
             # Array of individual_ids to unenroll.
             individual_ids: nil,

data/rbi/finch_api/models/hris/company_retrieve_params.rbi

@@ -15,7 +15,8 @@ module FinchAPI
             )
           end
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -29,7 +30,8 @@ module FinchAPI
           ).returns(T.attached_class)
         end
         def self.new(
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           request_options: {}
         )

data/rbi/finch_api/models/hris/directory_list_individuals_params.rbi

@@ -15,7 +15,8 @@ module FinchAPI
             )
           end
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -45,7 +46,8 @@ module FinchAPI
           ).returns(T.attached_class)
         end
         def self.new(
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           # Number of employees to return (defaults to 100, maximum 10000)
           limit: nil,

data/rbi/finch_api/models/hris/directory_list_params.rbi

@@ -15,7 +15,8 @@ module FinchAPI
             )
           end
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -45,7 +46,8 @@ module FinchAPI
           ).returns(T.attached_class)
         end
         def self.new(
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           # Number of employees to return (defaults to 100, maximum 10000)
           limit: nil,

data/rbi/finch_api/models/hris/document_list_params.rbi

@@ -15,7 +15,8 @@ module FinchAPI
             )
           end
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -73,7 +74,8 @@ module FinchAPI
           ).returns(T.attached_class)
         end
         def self.new(
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           # Comma-delimited list of stable Finch uuids for each individual. If empty,
           # defaults to all individuals

data/rbi/finch_api/models/hris/document_retreive_params.rbi

@@ -18,7 +18,8 @@ module FinchAPI
         sig { returns(String) }
         attr_accessor :document_id
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -34,7 +35,8 @@ module FinchAPI
         end
         def self.new(
           document_id:,
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           request_options: {}
         )

data/rbi/finch_api/models/hris/employment_data.rbi

@@ -99,10 +99,20 @@ module FinchAPI
           end
           attr_accessor :flsa_status
 
+          # IRS flag indicating whether the employee is classified as a Highly Compensated
+          # Employee for nondiscrimination testing purposes (ADP/ACP tests). US-only.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_accessor :highly_compensated_employee
+
           # `true` if the individual an an active employee or contractor at the company.
           sig { returns(T.nilable(T::Boolean)) }
           attr_accessor :is_active
 
+          # IRS flag indicating whether the employee is classified as a Key Employee for
+          # top-heavy testing purposes. US-only.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_accessor :key_employee
+
           # The legal last name of the individual.
           sig { returns(T.nilable(String)) }
           attr_accessor :last_name
@@ -147,6 +157,15 @@ module FinchAPI
           sig { returns(T.nilable(String)) }
           attr_accessor :title
 
+          # The code identifying the union the employee is a member of, as configured in the
+          # payroll system.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :union_code
+
+          # The local chapter or local number within the employee's union.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :union_local
+
           # Custom fields for the individual. These are fields which are defined by the
           # employer in the system. Custom fields are not currently supported for assisted
           # connections.
@@ -204,7 +223,9 @@ module FinchAPI
                 T.nilable(
                   FinchAPI::HRIS::EmploymentData::EmploymentDataResponseBody::FlsaStatus::OrSymbol
                 ),
+              highly_compensated_employee: T.nilable(T::Boolean),
               is_active: T.nilable(T::Boolean),
+              key_employee: T.nilable(T::Boolean),
               last_name: T.nilable(String),
               latest_rehire_date: T.nilable(String),
               location: T.nilable(FinchAPI::Location::OrHash),
@@ -215,6 +236,8 @@ module FinchAPI
               middle_name: T.nilable(String),
               start_date: T.nilable(String),
               title: T.nilable(String),
+              union_code: T.nilable(String),
+              union_local: T.nilable(String),
               custom_fields:
                 T.nilable(
                   T::Array[
@@ -245,8 +268,14 @@ module FinchAPI
             # The FLSA status of the individual. Available options: `exempt`, `non_exempt`,
             # `unknown`.
             flsa_status:,
+            # IRS flag indicating whether the employee is classified as a Highly Compensated
+            # Employee for nondiscrimination testing purposes (ADP/ACP tests). US-only.
+            highly_compensated_employee:,
             # `true` if the individual an an active employee or contractor at the company.
             is_active:,
+            # IRS flag indicating whether the employee is classified as a Key Employee for
+            # top-heavy testing purposes. US-only.
+            key_employee:,
             # The legal last name of the individual.
             last_name:,
             latest_rehire_date:,
@@ -258,6 +287,11 @@ module FinchAPI
             start_date:,
             # The current title of the individual.
             title:,
+            # The code identifying the union the employee is a member of, as configured in the
+            # payroll system.
+            union_code:,
+            # The local chapter or local number within the employee's union.
+            union_local:,
             # Custom fields for the individual. These are fields which are defined by the
             # employer in the system. Custom fields are not currently supported for assisted
             # connections.
@@ -298,7 +332,9 @@ module FinchAPI
                   T.nilable(
                     FinchAPI::HRIS::EmploymentData::EmploymentDataResponseBody::FlsaStatus::TaggedSymbol
                   ),
+                highly_compensated_employee: T.nilable(T::Boolean),
                 is_active: T.nilable(T::Boolean),
+                key_employee: T.nilable(T::Boolean),
                 last_name: T.nilable(String),
                 latest_rehire_date: T.nilable(String),
                 location: T.nilable(FinchAPI::Location),
@@ -309,6 +345,8 @@ module FinchAPI
                 middle_name: T.nilable(String),
                 start_date: T.nilable(String),
                 title: T.nilable(String),
+                union_code: T.nilable(String),
+                union_local: T.nilable(String),
                 custom_fields:
                   T.nilable(
                     T::Array[

data/rbi/finch_api/models/hris/employment_retrieve_many_params.rbi

@@ -23,7 +23,8 @@ module FinchAPI
         end
         attr_accessor :requests
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -43,7 +44,8 @@ module FinchAPI
         def self.new(
           # The array of batch requests. Maximum 10000 items per request.
           requests:,
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           request_options: {}
         )

data/rbi/finch_api/models/hris/individual.rbi

@@ -58,6 +58,17 @@ module FinchAPI
           sig { returns(T.nilable(String)) }
           attr_accessor :last_name
 
+          # The employee's marital status, used for beneficiary designation and spousal
+          # consent workflows.
+          sig do
+            returns(
+              T.nilable(
+                FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus::TaggedSymbol
+              )
+            )
+          end
+          attr_accessor :marital_status
+
           # The legal middle name of the individual.
           sig { returns(T.nilable(String)) }
           attr_accessor :middle_name
@@ -123,6 +134,10 @@ module FinchAPI
                   FinchAPI::HRIS::Individual::IndividualResponseBody::Gender::OrSymbol
                 ),
               last_name: T.nilable(String),
+              marital_status:
+                T.nilable(
+                  FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus::OrSymbol
+                ),
               middle_name: T.nilable(String),
               phone_numbers:
                 T.nilable(
@@ -156,6 +171,9 @@ module FinchAPI
             gender:,
             # The legal last name of the individual.
             last_name:,
+            # The employee's marital status, used for beneficiary designation and spousal
+            # consent workflows.
+            marital_status:,
             # The legal middle name of the individual.
             middle_name:,
             phone_numbers:,
@@ -190,6 +208,10 @@ module FinchAPI
                     FinchAPI::HRIS::Individual::IndividualResponseBody::Gender::TaggedSymbol
                   ),
                 last_name: T.nilable(String),
+                marital_status:
+                  T.nilable(
+                    FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus::TaggedSymbol
+                  ),
                 middle_name: T.nilable(String),
                 phone_numbers:
                   T.nilable(
@@ -325,6 +347,62 @@ module FinchAPI
             end
           end
 
+          # The employee's marital status, used for beneficiary designation and spousal
+          # consent workflows.
+          module MaritalStatus
+            extend FinchAPI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            SINGLE =
+              T.let(
+                :single,
+                FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus::TaggedSymbol
+              )
+            MARRIED =
+              T.let(
+                :married,
+                FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus::TaggedSymbol
+              )
+            DIVORCED =
+              T.let(
+                :divorced,
+                FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus::TaggedSymbol
+              )
+            WIDOWED =
+              T.let(
+                :widowed,
+                FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus::TaggedSymbol
+              )
+            DOMESTIC_PARTNER =
+              T.let(
+                :domestic_partner,
+                FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus::TaggedSymbol
+              )
+            UNKNOWN =
+              T.let(
+                :unknown,
+                FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  FinchAPI::HRIS::Individual::IndividualResponseBody::MaritalStatus::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
           class PhoneNumber < FinchAPI::Internal::Type::BaseModel
             OrHash =
               T.type_alias do

data/rbi/finch_api/models/hris/individual_retrieve_many_params.rbi

@@ -23,7 +23,8 @@ module FinchAPI
         end
         attr_accessor :requests
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -64,7 +65,8 @@ module FinchAPI
         def self.new(
           # The array of batch requests. Maximum 10000 items per request.
           requests:,
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           options: nil,
           request_options: {}

data/rbi/finch_api/models/hris/pay_statement_item/rule_create_params.rbi

@@ -16,7 +16,8 @@ module FinchAPI
               )
             end
 
-          # The entity IDs to create the rule for.
+          # The entity IDs to create the rule for. Provide exactly one entity ID per
+          # request; a maximum of one is accepted.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :entity_ids
 
@@ -105,7 +106,8 @@ module FinchAPI
             ).returns(T.attached_class)
           end
           def self.new(
-            # The entity IDs to create the rule for.
+            # The entity IDs to create the rule for. Provide exactly one entity ID per
+            # request; a maximum of one is accepted.
             entity_ids: nil,
             # Specifies the fields to be applied when the condition is met.
             attributes: nil,

data/rbi/finch_api/models/hris/pay_statement_item/rule_delete_params.rbi

@@ -19,7 +19,8 @@ module FinchAPI
           sig { returns(String) }
           attr_accessor :rule_id
 
-          # The entity IDs to delete the rule for.
+          # The entity IDs to delete the rule for. Provide exactly one entity ID per
+          # request; a maximum of one is accepted.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :entity_ids
 
@@ -35,7 +36,8 @@ module FinchAPI
           end
           def self.new(
             rule_id:,
-            # The entity IDs to delete the rule for.
+            # The entity IDs to delete the rule for. Provide exactly one entity ID per
+            # request; a maximum of one is accepted.
             entity_ids: nil,
             request_options: {}
           )

data/rbi/finch_api/models/hris/pay_statement_item/rule_list_params.rbi

@@ -16,7 +16,8 @@ module FinchAPI
               )
             end
 
-          # The entity IDs to retrieve rules for.
+          # The entity IDs to retrieve rules for. Provide exactly one entity ID per request;
+          # a maximum of one is accepted.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :entity_ids
 
@@ -30,7 +31,8 @@ module FinchAPI
             ).returns(T.attached_class)
           end
           def self.new(
-            # The entity IDs to retrieve rules for.
+            # The entity IDs to retrieve rules for. Provide exactly one entity ID per request;
+            # a maximum of one is accepted.
             entity_ids: nil,
             request_options: {}
           )

data/rbi/finch_api/models/hris/pay_statement_item/rule_update_params.rbi

@@ -19,7 +19,8 @@ module FinchAPI
           sig { returns(String) }
           attr_accessor :rule_id
 
-          # The entity IDs to update the rule for.
+          # The entity IDs to update the rule for. Provide exactly one entity ID per
+          # request; a maximum of one is accepted.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :entity_ids
 
@@ -42,7 +43,8 @@ module FinchAPI
           end
           def self.new(
             rule_id:,
-            # The entity IDs to update the rule for.
+            # The entity IDs to update the rule for. Provide exactly one entity ID per
+            # request; a maximum of one is accepted.
             entity_ids: nil,
             optional_property: nil,
             request_options: {}

data/rbi/finch_api/models/hris/pay_statement_item_list_params.rbi

@@ -46,7 +46,8 @@ module FinchAPI
         sig { params(end_date: Date).void }
         attr_writer :end_date
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -96,7 +97,8 @@ module FinchAPI
           # The end date to retrieve pay statement items by via their last seen pay date in
           # `YYYY-MM-DD` format.
           end_date: nil,
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           # Case-insensitive partial match search by pay statement item name.
           name: nil,

data/rbi/finch_api/models/hris/pay_statement_retrieve_many_params.rbi

@@ -23,7 +23,8 @@ module FinchAPI
         end
         attr_accessor :requests
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -43,7 +44,8 @@ module FinchAPI
         def self.new(
           # The array of batch requests. Maximum 10 payment_ids per request.
           requests:,
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           request_options: {}
         )

data/rbi/finch_api/models/hris/payment_list_params.rbi

@@ -25,7 +25,8 @@ module FinchAPI
         sig { returns(Date) }
         attr_accessor :start_date
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -47,7 +48,8 @@ module FinchAPI
           # The start date to retrieve payments by a company (inclusive) in `YYYY-MM-DD`
           # format. Filters payments by their **pay_date** field.
           start_date:,
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           request_options: {}
         )

data/rbi/finch_api/models/introspection.rbi

@@ -72,8 +72,7 @@ module FinchAPI
       end
       attr_writer :authentication_methods
 
-      # [DEPRECATED] Use `connection_id` to associate tokens with a Finch connection
-      # instead of this company ID
+      # The Finch UUID of the company associated with the `access_token`.
       sig { returns(T.nilable(String)) }
       attr_reader :company_id
 
@@ -172,8 +171,7 @@ module FinchAPI
         # instead of this account ID
         account_id: nil,
         authentication_methods: nil,
-        # [DEPRECATED] Use `connection_id` to associate tokens with a Finch connection
-        # instead of this company ID
+        # The Finch UUID of the company associated with the `access_token`.
         company_id: nil,
         # The email of your customer you provided to Finch when a connect session was
         # created for this connection

data/rbi/finch_api/models/payroll/pay_group_list_params.rbi

@@ -15,7 +15,8 @@ module FinchAPI
             )
           end
 
-        # The entity IDs to specify which entities' data to access.
+        # The entity IDs to specify which entities' data to access. Provide exactly one
+        # entity ID per request; a maximum of one is accepted.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :entity_ids
 
@@ -43,7 +44,8 @@ module FinchAPI
           ).returns(T.attached_class)
         end
         def self.new(
-          # The entity IDs to specify which entities' data to access.
+          # The entity IDs to specify which entities' data to access. Provide exactly one
+          # entity ID per request; a maximum of one is accepted.
           entity_ids: nil,
           individual_id: nil,
           pay_frequencies: nil,