vitable-connect 0.4.0 → 0.6.0

data/lib/vitable_connect/resources/enrollments.rb

@@ -24,6 +24,81 @@ module VitableConnect
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {VitableConnect::Models::EnrollmentReissueParams} for more details.
+      #
+      # Closes the targeted enrollment and creates a new unanswered enrollment for the
+      # same member and plan year. VPC never requires a qualifying life event; other
+      # products require an accepted, member-owned event outside open enrollment.
+      # User-backed callers must provide a reason; it is optional for userless
+      # organization callers. API keys and unbound access tokens may act across the
+      # caller organization's book. Employer-bound access tokens may act only on that
+      # employer's enrollments, and employee-bound access tokens may act only on that
+      # employee's enrollment. Tenant or token-scope mismatches return the same
+      # non-disclosing 404 before the request body is validated.
+      #
+      # @overload reissue(enrollment_id, qualifying_life_event_id: nil, reason: nil, ticket_number: nil, request_options: {})
+      #
+      # @param enrollment_id [String] Unique enrollment identifier (enrl\_\*)
+      #
+      # @param qualifying_life_event_id [String, nil] Accepted member qualifying life event identifier (qle\_\*)
+      #
+      # @param reason [String, nil] Audit reason for the reissue; required for user-backed callers and optional for
+      #
+      # @param ticket_number [String, nil] Optional support or operational ticket number
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::EnrollmentReissueResponse]
+      #
+      # @see VitableConnect::Models::EnrollmentReissueParams
+      def reissue(enrollment_id, params = {})
+        parsed, options = VitableConnect::EnrollmentReissueParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/enrollments/%1$s/reissue", enrollment_id],
+          body: parsed,
+          model: VitableConnect::Models::EnrollmentReissueResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {VitableConnect::Models::EnrollmentTerminateParams} for more details.
+      #
+      # Terminates enrolled coverage immediately. An accepted qualifying life event
+      # owned by the enrollment member is required unless the plan is VPC or ICHRA.
+      # User-backed callers must provide a reason; it is optional for userless
+      # organization callers. API keys may act across the caller organization's book.
+      # Tenant mismatches return the same non-disclosing 404 before the request body is
+      # validated.
+      #
+      # @overload terminate(enrollment_id, qualifying_life_event_id: nil, reason: nil, ticket_number: nil, request_options: {})
+      #
+      # @param enrollment_id [String] Unique enrollment identifier (enrl\_\*)
+      #
+      # @param qualifying_life_event_id [String, nil] Accepted member qualifying life event identifier (qle\_\*)
+      #
+      # @param reason [String, nil] Audit reason for the termination; required for user-backed callers and optional
+      #
+      # @param ticket_number [String, nil] Optional support or operational ticket number
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see VitableConnect::Models::EnrollmentTerminateParams
+      def terminate(enrollment_id, params = {})
+        parsed, options = VitableConnect::EnrollmentTerminateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/enrollments/%1$s/terminate", enrollment_id],
+          body: parsed,
+          model: NilClass,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [VitableConnect::Client]

data/lib/vitable_connect/resources/members.rb

@@ -0,0 +1,231 @@
+# frozen_string_literal: true
+
+module VitableConnect
+  module Resources
+    # Browse the members covered across your book and read a member's profile
+    class Members
+      # Retrieves a member's profile by ID — identity, demographics, address, contact
+      # details, tobacco status, and profile status. Access is scoped to the
+      # authenticated principal; a member not visible to the caller returns a 404.
+      #
+      # @overload retrieve(member_id, request_options: {})
+      #
+      # @param member_id [String]
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::MemberRetrieveResponse]
+      #
+      # @see VitableConnect::Models::MemberRetrieveParams
+      def retrieve(member_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/members/%1$s", member_id],
+          model: VitableConnect::Models::MemberRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Retrieves a paginated list of the members in the authenticated organization's
+      # book — identity, contact details, and address. The book covers members reached
+      # through an employer in the organization's book as well as members of a group it
+      # owns. Supports free-text search (name, email, or exact member id).
+      #
+      # @overload list(limit: nil, page: nil, search: nil, request_options: {})
+      #
+      # @param limit [Integer] Items per page (default: 20, max: 100)
+      #
+      # @param page [Integer] Page number (default: 1)
+      #
+      # @param search [String] Case-insensitive search across member name and email; exact match on member id
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Internal::PageNumberPage<VitableConnect::Models::MemberListResponse>]
+      #
+      # @see VitableConnect::Models::MemberListParams
+      def list(params = {})
+        parsed, options = VitableConnect::MemberListParams.dump_request(params)
+        query = VitableConnect::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "v2/members",
+          query: query,
+          page: VitableConnect::Internal::PageNumberPage,
+          model: VitableConnect::Models::MemberListResponse,
+          options: options
+        )
+      end
+
+      # Lists a member's active legal dependents — name, relationship, date of birth,
+      # age, and sex at birth. Access is scoped to the authenticated principal; a member
+      # not visible to the caller returns a 404.
+      #
+      # @overload list_dependents(member_id, request_options: {})
+      #
+      # @param member_id [String]
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::MemberListDependentsResponse]
+      #
+      # @see VitableConnect::Models::MemberListDependentsParams
+      def list_dependents(member_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/members/%1$s/dependents", member_id],
+          model: VitableConnect::Models::MemberListDependentsResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Lists a member's employment across every employer — the same employee record
+      # shape as the employer's employees list, plus the employer name. For an
+      # organization caller the rows are scoped to companies in that organization's
+      # book; a member (self/household) or Vitable Admin sees all employments. A member
+      # not visible to the caller returns a 404.
+      #
+      # @overload list_employments(member_id, request_options: {})
+      #
+      # @param member_id [String]
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::MemberListEmploymentsResponse]
+      #
+      # @see VitableConnect::Models::MemberListEmploymentsParams
+      def list_employments(member_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/members/%1$s/employments", member_id],
+          model: VitableConnect::Models::MemberListEmploymentsResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Lists a member's benefit enrollments across every employer — benefit type and
+      # product, employer, carrier, plan, tier, employee deduction, employer
+      # contribution and total premium, the individual enrollment coverage boundary
+      # (`coverage_end`), the distinct benefit plan-year boundary
+      # (`plan_year_coverage_end`) used to determine whether the plan year itself has
+      # ended, whether a qualifying life event would currently be required for reissue
+      # under the product/open-enrollment rule, enrollment/open-enrollment window, and
+      # two statuses: `election_status` (what the member answered) and `policy_status`
+      # (what became of their coverage, null unless they enrolled). Every row includes a
+      # stable enrollment ID that can be used to target enrollment actions. The full
+      # list is returned across all states so the client derives active plans (effective
+      # and upcoming) and the enrollment history from those per-row statuses. For an
+      # organization caller the rows are scoped to companies in that organization's
+      # book; a member (self/household) or Vitable Admin sees all enrollments. A member
+      # not visible to the caller returns a 404.
+      #
+      # @overload list_enrollments(member_id, request_options: {})
+      #
+      # @param member_id [String]
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::MemberListEnrollmentsResponse]
+      #
+      # @see VitableConnect::Models::MemberListEnrollmentsParams
+      def list_enrollments(member_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/members/%1$s/enrollments", member_id],
+          model: VitableConnect::Models::MemberListEnrollmentsResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Lists a member's benefit ID cards — card type (medical, dental, vision, or rx),
+      # employer, plan, provider network, claims payer, carrier contact details, and the
+      # disclaimers printed on the card. Medical, dental and vision cards come from the
+      # member's active digital benefit cards; the rx card from the member's Ventegra
+      # pharmacy benefit (omitted when the member has no free-medication coverage),
+      # which carries no plan, network, or carrier details. Access is scoped to the
+      # authenticated principal, and an organization caller sees only cards from
+      # employers in its book; a member not visible to the caller returns a 404.
+      #
+      # @overload list_id_cards(member_id, request_options: {})
+      #
+      # @param member_id [String]
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::MemberListIDCardsResponse]
+      #
+      # @see VitableConnect::Models::MemberListIDCardsParams
+      def list_id_cards(member_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/members/%1$s/id-cards", member_id],
+          model: VitableConnect::Models::MemberListIDCardsResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Lists a member's qualifying life events, including events already used for
+      # another enrollment. Returns all statuses by default; pass the status query param
+      # to filter to one (e.g. approved). Events are ordered newest submission first
+      # with stable paging. Custom text is present only when submitted and is otherwise
+      # null. A member not visible to the caller returns a 404. API keys and unbound
+      # access tokens have organization-wide access. Employer-bound tokens require
+      # employment at the bound employer, and employee-bound tokens require the exact
+      # employee-member relationship. Organization or scope mismatches return a 404
+      # before pagination is validated.
+      #
+      # @overload list_qualifying_life_events(member_id, limit: nil, page: nil, status: nil, request_options: {})
+      #
+      # @param member_id [String] Unique member identifier (mbr\_\*)
+      #
+      # @param limit [Integer] Items per page (default: 20, max: 100)
+      #
+      # @param page [Integer] Page number (default: 1)
+      #
+      # @param status [Symbol, VitableConnect::Models::MemberListQualifyingLifeEventsParams::Status] Optional. Filter to a single QLE status; omit to return all statuses.
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Internal::PageNumberPage<VitableConnect::Models::MemberListQualifyingLifeEventsResponse>]
+      #
+      # @see VitableConnect::Models::MemberListQualifyingLifeEventsParams
+      def list_qualifying_life_events(member_id, params = {})
+        parsed, options = VitableConnect::MemberListQualifyingLifeEventsParams.dump_request(params)
+        query = VitableConnect::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["v1/members/%1$s/qualifying-life-events", member_id],
+          query: query,
+          page: VitableConnect::Internal::PageNumberPage,
+          model: VitableConnect::Models::MemberListQualifyingLifeEventsResponse,
+          options: options
+        )
+      end
+
+      # Lists a member's household as a per-participant table — the account holder plus
+      # each active household member, with name, relationship, member type, date of
+      # birth, and household-admin flag. Access is scoped to the authenticated
+      # principal; a member not visible to the caller (or with no household) returns
+      # a 404.
+      #
+      # @overload retrieve_household(member_id, request_options: {})
+      #
+      # @param member_id [String]
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::MemberRetrieveHouseholdResponse]
+      #
+      # @see VitableConnect::Models::MemberRetrieveHouseholdParams
+      def retrieve_household(member_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/members/%1$s/household", member_id],
+          model: VitableConnect::Models::MemberRetrieveHouseholdResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [VitableConnect::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/vitable_connect/resources/organizations.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module VitableConnect
+  module Resources
+    class Organizations
+      # Some parameter documentations has been truncated, see
+      # {VitableConnect::Models::OrganizationCreateParams} for more details.
+      #
+      # Onboards the authenticated user's partner Organization: creates the local
+      # Organization + the creator's admin membership atomically, then mirrors it to
+      # WorkOS (creates the WorkOS org and binds the creator as admin). 409
+      # `organization_already_exists` when the user already has an organization (v0: one
+      # organization per user).
+      #
+      # @overload create(name:, type: nil, request_options: {})
+      #
+      # @param name [String]
+      #
+      # @param type [Symbol, VitableConnect::Models::OrganizationCreateParams::Type, nil] - `BROKERAGE` - BROKERAGE
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::OrganizationCreateResponse]
+      #
+      # @see VitableConnect::Models::OrganizationCreateParams
+      def create(params)
+        parsed, options = VitableConnect::OrganizationCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/organizations",
+          body: parsed,
+          model: VitableConnect::Models::OrganizationCreateResponse,
+          security: {},
+          options: options
+        )
+      end
+
+      # Lists the organizations the authenticated caller is an active member of
+      # (paginated). Returns an empty list when the caller belongs to no organizations.
+      #
+      # @overload list(request_options: {})
+      #
+      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [VitableConnect::Models::OrganizationListResponse]
+      #
+      # @see VitableConnect::Models::OrganizationListParams
+      def list(params = {})
+        @client.request(
+          method: :get,
+          path: "v1/organizations",
+          model: VitableConnect::Models::OrganizationListResponse,
+          security: {},
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [VitableConnect::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/vitable_connect/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module VitableConnect
-  VERSION = "0.4.0"
+  VERSION = "0.6.0"
 end

data/lib/vitable_connect.rb

@@ -55,29 +55,54 @@ require_relative "vitable_connect/client"
 require_relative "vitable_connect/internal/page_number_page"
 require_relative "vitable_connect/models/auth_issue_access_token_params"
 require_relative "vitable_connect/models/auth_issue_access_token_response"
-require_relative "vitable_connect/models/benefit_eligibility_policy"
-require_relative "vitable_connect/models/benefit_eligibility_policy_response"
-require_relative "vitable_connect/models/benefit_eligibility_policy_retrieve_params"
 require_relative "vitable_connect/models/employee"
 require_relative "vitable_connect/models/employee_class"
 require_relative "vitable_connect/models/employee_list_enrollments_params"
 require_relative "vitable_connect/models/employee_retrieve_params"
 require_relative "vitable_connect/models/employee_retrieve_response"
+require_relative "vitable_connect/models/employee_update_params"
+require_relative "vitable_connect/models/employee_update_response"
 require_relative "vitable_connect/models/employer"
-require_relative "vitable_connect/models/employer_create_benefit_eligibility_policy_params"
 require_relative "vitable_connect/models/employer_create_params"
+require_relative "vitable_connect/models/employer_ensure_payroll_integration_email_params"
+require_relative "vitable_connect/models/employer_ensure_payroll_integration_email_response"
+require_relative "vitable_connect/models/employer_list_benefit_plan_year_enrollments_params"
+require_relative "vitable_connect/models/employer_list_benefit_plan_year_enrollments_response"
+require_relative "vitable_connect/models/employer_list_benefit_plan_years_params"
+require_relative "vitable_connect/models/employer_list_benefit_plan_years_response"
 require_relative "vitable_connect/models/employer_list_employees_params"
+require_relative "vitable_connect/models/employer_list_hris_providers_params"
+require_relative "vitable_connect/models/employer_list_hris_providers_response"
+require_relative "vitable_connect/models/employer_list_invoices_params"
+require_relative "vitable_connect/models/employer_list_invoices_response"
 require_relative "vitable_connect/models/employer_list_params"
+require_relative "vitable_connect/models/employer_list_payroll_deduction_statements_params"
+require_relative "vitable_connect/models/employer_list_payroll_deduction_statements_response"
+require_relative "vitable_connect/models/employer_list_response"
 require_relative "vitable_connect/models/employer_response"
+require_relative "vitable_connect/models/employer_retrieve_benefit_plan_year_params"
+require_relative "vitable_connect/models/employer_retrieve_benefit_plan_year_response"
+require_relative "vitable_connect/models/employer_retrieve_hris_params"
+require_relative "vitable_connect/models/employer_retrieve_hris_response"
+require_relative "vitable_connect/models/employer_retrieve_invoice_pdf_params"
+require_relative "vitable_connect/models/employer_retrieve_invoice_pdf_response"
 require_relative "vitable_connect/models/employer_retrieve_params"
+require_relative "vitable_connect/models/employer_retrieve_payroll_access_setup_params"
+require_relative "vitable_connect/models/employer_retrieve_payroll_access_setup_response"
 require_relative "vitable_connect/models/employer_submit_census_sync_params"
 require_relative "vitable_connect/models/employer_submit_census_sync_response"
+require_relative "vitable_connect/models/employer_submit_payroll_access_setup_params"
+require_relative "vitable_connect/models/employer_submit_payroll_access_setup_response"
+require_relative "vitable_connect/models/employer_update_params"
 require_relative "vitable_connect/models/employer_update_settings_params"
 require_relative "vitable_connect/models/employer_update_settings_response"
 require_relative "vitable_connect/models/enrollment"
+require_relative "vitable_connect/models/enrollment_reissue_params"
+require_relative "vitable_connect/models/enrollment_reissue_response"
 require_relative "vitable_connect/models/enrollment_retrieve_params"
 require_relative "vitable_connect/models/enrollment_retrieve_response"
 require_relative "vitable_connect/models/enrollment_status"
+require_relative "vitable_connect/models/enrollment_terminate_params"
 require_relative "vitable_connect/models/group"
 require_relative "vitable_connect/models/group_create_params"
 require_relative "vitable_connect/models/group_list_params"
@@ -88,10 +113,29 @@ require_relative "vitable_connect/models/groups/members/sync_retrieve_response"
 require_relative "vitable_connect/models/groups/members/sync_submit_params"
 require_relative "vitable_connect/models/groups/members/sync_submit_response"
 require_relative "vitable_connect/models/group_update_params"
+require_relative "vitable_connect/models/member_list_dependents_params"
+require_relative "vitable_connect/models/member_list_dependents_response"
+require_relative "vitable_connect/models/member_list_employments_params"
+require_relative "vitable_connect/models/member_list_employments_response"
+require_relative "vitable_connect/models/member_list_enrollments_params"
+require_relative "vitable_connect/models/member_list_enrollments_response"
+require_relative "vitable_connect/models/member_list_id_cards_params"
+require_relative "vitable_connect/models/member_list_id_cards_response"
+require_relative "vitable_connect/models/member_list_params"
+require_relative "vitable_connect/models/member_list_qualifying_life_events_params"
+require_relative "vitable_connect/models/member_list_qualifying_life_events_response"
+require_relative "vitable_connect/models/member_list_response"
+require_relative "vitable_connect/models/member_retrieve_household_params"
+require_relative "vitable_connect/models/member_retrieve_household_response"
+require_relative "vitable_connect/models/member_retrieve_params"
+require_relative "vitable_connect/models/member_retrieve_response"
+require_relative "vitable_connect/models/organization_create_params"
+require_relative "vitable_connect/models/organization_create_response"
+require_relative "vitable_connect/models/organization_list_params"
+require_relative "vitable_connect/models/organization_list_response"
 require_relative "vitable_connect/models/pagination"
 require_relative "vitable_connect/models/plan_list_params"
 require_relative "vitable_connect/models/plan_list_response"
-require_relative "vitable_connect/models/type"
 require_relative "vitable_connect/models/webhook_event"
 require_relative "vitable_connect/models/webhook_event_list_deliveries_params"
 require_relative "vitable_connect/models/webhook_event_list_deliveries_response"
@@ -100,12 +144,13 @@ require_relative "vitable_connect/models/webhook_event_retrieve_params"
 require_relative "vitable_connect/models/webhook_event_retrieve_response"
 require_relative "vitable_connect/models"
 require_relative "vitable_connect/resources/auth"
-require_relative "vitable_connect/resources/benefit_eligibility_policies"
 require_relative "vitable_connect/resources/employees"
 require_relative "vitable_connect/resources/employers"
 require_relative "vitable_connect/resources/enrollments"
 require_relative "vitable_connect/resources/groups"
 require_relative "vitable_connect/resources/groups/members"
 require_relative "vitable_connect/resources/groups/members/sync"
+require_relative "vitable_connect/resources/members"
+require_relative "vitable_connect/resources/organizations"
 require_relative "vitable_connect/resources/plans"
 require_relative "vitable_connect/resources/webhook_events"

data/rbi/vitable_connect/client.rbi

@@ -28,10 +28,6 @@ module VitableConnect
     sig { returns(VitableConnect::Resources::Auth) }
     attr_reader :auth
 
-    # Define rules that determine which employees qualify for benefits
-    sig { returns(VitableConnect::Resources::BenefitEligibilityPolicies) }
-    attr_reader :benefit_eligibility_policies
-
     sig { returns(VitableConnect::Resources::Employees) }
     attr_reader :employees
 
@@ -48,12 +44,28 @@ module VitableConnect
     sig { returns(VitableConnect::Resources::Groups) }
     attr_reader :groups
 
+    # Browse the members covered across your book and read a member's profile
+    sig { returns(VitableConnect::Resources::Members) }
+    attr_reader :members
+
+    sig { returns(VitableConnect::Resources::Organizations) }
+    attr_reader :organizations
+
     sig { returns(VitableConnect::Resources::Plans) }
     attr_reader :plans
 
     # @api private
-    sig { override.returns(T::Hash[String, String]) }
-    private def auth_headers
+    sig do
+      override
+        .params(security: { api_key_auth: T::Boolean })
+        .returns(T::Hash[String, String])
+    end
+    private def auth_headers(security:)
+    end
+
+    # @api private
+    sig { returns(T::Hash[String, String]) }
+    private def api_key_auth
     end
 
     # Creates and returns a new client for interacting with the API.

data/rbi/vitable_connect/internal/transport/base_client.rbi

@@ -52,6 +52,7 @@ module VitableConnect
               stream: T.nilable(T::Class[T.anything]),
               model:
                 T.nilable(VitableConnect::Internal::Type::Converter::Input),
+              security: T.nilable({ api_key_auth: T::Boolean }),
               options: T.nilable(VitableConnect::RequestOptions::OrHash)
             }
           end
@@ -238,7 +239,7 @@ module VitableConnect
         # Execute the request specified by `req`. This is the method that all resource
         # methods call into.
         #
-        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: VitableConnect::Internal::Type::Unknown, options: {})
+        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: VitableConnect::Internal::Type::Unknown, security: {api_key_auth: true}, options: {})
         sig do
           params(
             method: Symbol,
@@ -280,6 +281,7 @@ module VitableConnect
               ),
             stream: T.nilable(T::Class[T.anything]),
             model: T.nilable(VitableConnect::Internal::Type::Converter::Input),
+            security: T.nilable({ api_key_auth: T::Boolean }),
             options: T.nilable(VitableConnect::RequestOptions::OrHash)
           ).returns(T.anything)
         end
@@ -293,6 +295,7 @@ module VitableConnect
           page: nil,
           stream: nil,
           model: VitableConnect::Internal::Type::Unknown,
+          security: { api_key_auth: true },
           options: {}
         )
         end

data/rbi/vitable_connect/models/auth_issue_access_token_params.rbi

@@ -117,14 +117,20 @@ module VitableConnect
 
         # - `employer` - employer
         # - `employee` - employee
-        sig { returns(VitableConnect::Type::OrSymbol) }
+        sig do
+          returns(
+            VitableConnect::AuthIssueAccessTokenParams::BoundEntity::Type::OrSymbol
+          )
+        end
         attr_accessor :type
 
         # Optional entity to bind the token to for scoped access
         sig do
-          params(id: String, type: VitableConnect::Type::OrSymbol).returns(
-            T.attached_class
-          )
+          params(
+            id: String,
+            type:
+              VitableConnect::AuthIssueAccessTokenParams::BoundEntity::Type::OrSymbol
+          ).returns(T.attached_class)
         end
         def self.new(
           # Prefixed entity ID to bind the token to (empr*\* for employer, empl*\* for
@@ -137,10 +143,52 @@ module VitableConnect
         end
 
         sig do
-          override.returns({ id: String, type: VitableConnect::Type::OrSymbol })
+          override.returns(
+            {
+              id: String,
+              type:
+                VitableConnect::AuthIssueAccessTokenParams::BoundEntity::Type::OrSymbol
+            }
+          )
         end
         def to_hash
         end
+
+        # - `employer` - employer
+        # - `employee` - employee
+        module Type
+          extend VitableConnect::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                VitableConnect::AuthIssueAccessTokenParams::BoundEntity::Type
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          EMPLOYER =
+            T.let(
+              :employer,
+              VitableConnect::AuthIssueAccessTokenParams::BoundEntity::Type::TaggedSymbol
+            )
+          EMPLOYEE =
+            T.let(
+              :employee,
+              VitableConnect::AuthIssueAccessTokenParams::BoundEntity::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                VitableConnect::AuthIssueAccessTokenParams::BoundEntity::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end