merge_ruby_client 0.0.3 → 0.0.5

data/lib/merge_ruby_client/hris/link_token/client.rb

@@ -9,33 +9,61 @@ require "async"
 module Merge
   module Hris
     class LinkTokenClient
+      # @return [Merge::RequestClient]
       attr_reader :request_client
 
-      # @param request_client [RequestClient]
-      # @return [Hris::LinkTokenClient]
+      # @param request_client [Merge::RequestClient]
+      # @return [Merge::Hris::LinkTokenClient]
       def initialize(request_client:)
-        # @type [RequestClient]
         @request_client = request_client
       end
 
       # Creates a link token to be used when linking a new end user.
       #
-      # @param end_user_email_address [String] Your end user's email address. This is purely for identification purposes - setting this value will not cause any emails to be sent.
+      # @param end_user_email_address [String] Your end user's email address. This is purely for identification purposes -
+      #  setting this value will not cause any emails to be sent.
       # @param end_user_organization_name [String] Your end user's organization.
-      # @param end_user_origin_id [String] This unique identifier typically represents the ID for your end user in your product's database. This value must be distinct from other Linked Accounts' unique identifiers.
-      # @param categories [Array<Hris::CATEGORIES_ENUM>] The integration categories to show in Merge Link.
-      # @param integration [String] The slug of a specific pre-selected integration for this linking flow token. For examples of slugs, see https://docs.merge.dev/guides/merge-link/single-integration/.
-      # @param link_expiry_mins [Integer] An integer number of minutes between [30, 720 or 10080 if for a Magic Link URL] for how long this token is valid. Defaults to 30.
-      # @param should_create_magic_link_url [Boolean] Whether to generate a Magic Link URL. Defaults to false. For more information on Magic Link, see https://merge.dev/blog/integrations-fast-say-hello-to-magic-link.
-      # @param common_models [Array<Hash>] An array of objects to specify the models and fields that will be disabled for a given Linked Account. Each object uses model_id, enabled_actions, and disabled_fields to specify the model, method, and fields that are scoped for a given Linked Account.Request of type Array<Hris::CommonModelScopesBodyRequest>, as a Hash
+      # @param end_user_origin_id [String] This unique identifier typically represents the ID for your end user in your
+      #  product's database. This value must be distinct from other Linked Accounts'
+      #  unique identifiers.
+      # @param categories [Array<Merge::Hris::CategoriesEnum>] The integration categories to show in Merge Link.
+      # @param integration [String] The slug of a specific pre-selected integration for this linking flow token. For
+      #  examples of slugs, see
+      #  https://docs.merge.dev/guides/merge-link/single-integration/.
+      # @param link_expiry_mins [Integer] An integer number of minutes between [30, 720 or 10080 if for a Magic Link URL]
+      #  for how long this token is valid. Defaults to 30.
+      # @param should_create_magic_link_url [Boolean] Whether to generate a Magic Link URL. Defaults to false. For more information on
+      #  Magic Link, see
+      #  https://merge.dev/blog/integrations-fast-say-hello-to-magic-link.
+      # @param common_models [Array<Hash>] An array of objects to specify the models and fields that will be disabled for a
+      #  given Linked Account. Each object uses model_id, enabled_actions, and
+      #  disabled_fields to specify the model, method, and fields that are scoped for a
+      #  given Linked Account.Request of type Array<Merge::Hris::CommonModelScopesBodyRequest>, as a Hash
       #   * :model_id (String)
-      #   * :enabled_actions (Array<Hris::ENABLED_ACTIONS_ENUM>)
+      #   * :enabled_actions (Array<Merge::Hris::EnabledActionsEnum>)
       #   * :disabled_fields (Array<String>)
-      # @param request_options [RequestOptions]
-      # @return [Hris::LinkToken]
+      # @param category_common_model_scopes [Hash{String => Array}] When creating a Link Token, you can set permissions for Common Models that will
+      #  apply to the account that is going to be linked. Any model or field not
+      #  specified in link token payload will default to existing settings.
+      # @param language [String] The language code for the language to localize Merge Link to.
+      # @param integration_specific_config [Hash{String => Object}] A JSON object containing integration-specific configuration options.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::LinkToken]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.create(
+      #    end_user_email_address: "example@gmail.com",
+      #    end_user_organization_name: "Test Organization",
+      #    end_user_origin_id: "12345",
+      #    categories: [HRIS]
+      #  )
       def create(end_user_email_address:, end_user_organization_name:, end_user_origin_id:, categories:,
-                 integration: nil, link_expiry_mins: nil, should_create_magic_link_url: nil, common_models: nil, request_options: nil)
-        response = @request_client.conn.post("/api/hris/v1/link-token") do |req|
+                 integration: nil, link_expiry_mins: nil, should_create_magic_link_url: nil, common_models: nil, category_common_model_scopes: nil, language: nil, integration_specific_config: nil, request_options: nil)
+        response = @request_client.conn.post do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -49,42 +77,74 @@ module Merge
             integration: integration,
             link_expiry_mins: link_expiry_mins,
             should_create_magic_link_url: should_create_magic_link_url,
-            common_models: common_models
+            common_models: common_models,
+            category_common_model_scopes: category_common_model_scopes,
+            language: language,
+            integration_specific_config: integration_specific_config
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/link-token"
         end
-        Hris::LinkToken.from_json(json_object: response.body)
+        Merge::Hris::LinkToken.from_json(json_object: response.body)
       end
     end
 
     class AsyncLinkTokenClient
+      # @return [Merge::AsyncRequestClient]
       attr_reader :request_client
 
-      # @param request_client [AsyncRequestClient]
-      # @return [Hris::AsyncLinkTokenClient]
+      # @param request_client [Merge::AsyncRequestClient]
+      # @return [Merge::Hris::AsyncLinkTokenClient]
       def initialize(request_client:)
-        # @type [AsyncRequestClient]
         @request_client = request_client
       end
 
       # Creates a link token to be used when linking a new end user.
       #
-      # @param end_user_email_address [String] Your end user's email address. This is purely for identification purposes - setting this value will not cause any emails to be sent.
+      # @param end_user_email_address [String] Your end user's email address. This is purely for identification purposes -
+      #  setting this value will not cause any emails to be sent.
       # @param end_user_organization_name [String] Your end user's organization.
-      # @param end_user_origin_id [String] This unique identifier typically represents the ID for your end user in your product's database. This value must be distinct from other Linked Accounts' unique identifiers.
-      # @param categories [Array<Hris::CATEGORIES_ENUM>] The integration categories to show in Merge Link.
-      # @param integration [String] The slug of a specific pre-selected integration for this linking flow token. For examples of slugs, see https://docs.merge.dev/guides/merge-link/single-integration/.
-      # @param link_expiry_mins [Integer] An integer number of minutes between [30, 720 or 10080 if for a Magic Link URL] for how long this token is valid. Defaults to 30.
-      # @param should_create_magic_link_url [Boolean] Whether to generate a Magic Link URL. Defaults to false. For more information on Magic Link, see https://merge.dev/blog/integrations-fast-say-hello-to-magic-link.
-      # @param common_models [Array<Hash>] An array of objects to specify the models and fields that will be disabled for a given Linked Account. Each object uses model_id, enabled_actions, and disabled_fields to specify the model, method, and fields that are scoped for a given Linked Account.Request of type Array<Hris::CommonModelScopesBodyRequest>, as a Hash
+      # @param end_user_origin_id [String] This unique identifier typically represents the ID for your end user in your
+      #  product's database. This value must be distinct from other Linked Accounts'
+      #  unique identifiers.
+      # @param categories [Array<Merge::Hris::CategoriesEnum>] The integration categories to show in Merge Link.
+      # @param integration [String] The slug of a specific pre-selected integration for this linking flow token. For
+      #  examples of slugs, see
+      #  https://docs.merge.dev/guides/merge-link/single-integration/.
+      # @param link_expiry_mins [Integer] An integer number of minutes between [30, 720 or 10080 if for a Magic Link URL]
+      #  for how long this token is valid. Defaults to 30.
+      # @param should_create_magic_link_url [Boolean] Whether to generate a Magic Link URL. Defaults to false. For more information on
+      #  Magic Link, see
+      #  https://merge.dev/blog/integrations-fast-say-hello-to-magic-link.
+      # @param common_models [Array<Hash>] An array of objects to specify the models and fields that will be disabled for a
+      #  given Linked Account. Each object uses model_id, enabled_actions, and
+      #  disabled_fields to specify the model, method, and fields that are scoped for a
+      #  given Linked Account.Request of type Array<Merge::Hris::CommonModelScopesBodyRequest>, as a Hash
       #   * :model_id (String)
-      #   * :enabled_actions (Array<Hris::ENABLED_ACTIONS_ENUM>)
+      #   * :enabled_actions (Array<Merge::Hris::EnabledActionsEnum>)
       #   * :disabled_fields (Array<String>)
-      # @param request_options [RequestOptions]
-      # @return [Hris::LinkToken]
+      # @param category_common_model_scopes [Hash{String => Array}] When creating a Link Token, you can set permissions for Common Models that will
+      #  apply to the account that is going to be linked. Any model or field not
+      #  specified in link token payload will default to existing settings.
+      # @param language [String] The language code for the language to localize Merge Link to.
+      # @param integration_specific_config [Hash{String => Object}] A JSON object containing integration-specific configuration options.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::LinkToken]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.create(
+      #    end_user_email_address: "example@gmail.com",
+      #    end_user_organization_name: "Test Organization",
+      #    end_user_origin_id: "12345",
+      #    categories: [HRIS]
+      #  )
       def create(end_user_email_address:, end_user_organization_name:, end_user_origin_id:, categories:,
-                 integration: nil, link_expiry_mins: nil, should_create_magic_link_url: nil, common_models: nil, request_options: nil)
+                 integration: nil, link_expiry_mins: nil, should_create_magic_link_url: nil, common_models: nil, category_common_model_scopes: nil, language: nil, integration_specific_config: nil, request_options: nil)
         Async do
-          response = @request_client.conn.post("/api/hris/v1/link-token") do |req|
+          response = @request_client.conn.post do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -98,10 +158,14 @@ module Merge
               integration: integration,
               link_expiry_mins: link_expiry_mins,
               should_create_magic_link_url: should_create_magic_link_url,
-              common_models: common_models
+              common_models: common_models,
+              category_common_model_scopes: category_common_model_scopes,
+              language: language,
+              integration_specific_config: integration_specific_config
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/link-token"
           end
-          Hris::LinkToken.from_json(json_object: response.body)
+          Merge::Hris::LinkToken.from_json(json_object: response.body)
         end
       end
     end

data/lib/merge_ruby_client/hris/linked_accounts/client.rb

@@ -8,42 +8,59 @@ require "async"
 module Merge
   module Hris
     class LinkedAccountsClient
+      # @return [Merge::RequestClient]
       attr_reader :request_client
 
-      # @param request_client [RequestClient]
-      # @return [Hris::LinkedAccountsClient]
+      # @param request_client [Merge::RequestClient]
+      # @return [Merge::Hris::LinkedAccountsClient]
       def initialize(request_client:)
-        # @type [RequestClient]
         @request_client = request_client
       end
 
       # List linked accounts for your organization.
       #
-      # @param category [LINKED_ACCOUNTS_LIST_REQUEST_CATEGORY] Options: ('hris', 'ats', 'accounting', 'ticketing', 'crm', 'mktg', 'filestorage')
-      #   - `hris` - hris
-      #   - `ats` - ats
-      #   - `accounting` - accounting
-      #   - `ticketing` - ticketing
-      #   - `crm` - crm
-      #   - `mktg` - mktg
-      #   - `filestorage` - filestorage
+      # @param category [Merge::Hris::LinkedAccounts::LinkedAccountsListRequestCategory] Options: ('hris', 'ats', 'accounting', 'ticketing', 'crm', 'mktg',
+      #  'filestorage')
+      #  - `hris` - hris
+      #  - `ats` - ats
+      #  - `accounting` - accounting
+      #  - `ticketing` - ticketing
+      #  - `crm` - crm
+      #  - `mktg` - mktg
+      #  - `filestorage` - filestorage
       # @param cursor [String] The pagination cursor value.
-      # @param end_user_email_address [String] If provided, will only return linked accounts associated with the given email address.
-      # @param end_user_organization_name [String] If provided, will only return linked accounts associated with the given organization name.
-      # @param end_user_origin_id [String] If provided, will only return linked accounts associated with the given origin ID.
-      # @param end_user_origin_ids [String] Comma-separated list of EndUser origin IDs, making it possible to specify multiple EndUsers at once.
+      # @param end_user_email_address [String] If provided, will only return linked accounts associated with the given email
+      #  address.
+      # @param end_user_organization_name [String] If provided, will only return linked accounts associated with the given
+      #  organization name.
+      # @param end_user_origin_id [String] If provided, will only return linked accounts associated with the given origin
+      #  ID.
+      # @param end_user_origin_ids [String] Comma-separated list of EndUser origin IDs, making it possible to specify
+      #  multiple EndUsers at once.
       # @param id [String]
-      # @param ids [String] Comma-separated list of LinkedAccount IDs, making it possible to specify multiple LinkedAccounts at once.
-      # @param include_duplicates [Boolean] If `true`, will include complete production duplicates of the account specified by the `id` query parameter in the response. `id` must be for a complete production linked account.
-      # @param integration_name [String] If provided, will only return linked accounts associated with the given integration name.
-      # @param is_test_account [String] If included, will only include test linked accounts. If not included, will only include non-test linked accounts.
+      # @param ids [String] Comma-separated list of LinkedAccount IDs, making it possible to specify
+      #  multiple LinkedAccounts at once.
+      # @param include_duplicates [Boolean] If `true`, will include complete production duplicates of the account specified
+      #  by the `id` query parameter in the response. `id` must be for a complete
+      #  production linked account.
+      # @param integration_name [String] If provided, will only return linked accounts associated with the given
+      #  integration name.
+      # @param is_test_account [String] If included, will only include test linked accounts. If not included, will only
+      #  include non-test linked accounts.
       # @param page_size [Integer] Number of results to return per page.
       # @param status [String] Filter by status. Options: `COMPLETE`, `INCOMPLETE`, `RELINK_NEEDED`
-      # @param request_options [RequestOptions]
-      # @return [Hris::PaginatedAccountDetailsAndActionsList]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::PaginatedAccountDetailsAndActionsList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.list
       def list(category: nil, cursor: nil, end_user_email_address: nil, end_user_organization_name: nil,
                end_user_origin_id: nil, end_user_origin_ids: nil, id: nil, ids: nil, include_duplicates: nil, integration_name: nil, is_test_account: nil, page_size: nil, status: nil, request_options: nil)
-        response = @request_client.conn.get("/api/hris/v1/linked-accounts") do |req|
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -64,49 +81,67 @@ module Merge
             "page_size": page_size,
             "status": status
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/linked-accounts"
         end
-        Hris::PaginatedAccountDetailsAndActionsList.from_json(json_object: response.body)
+        Merge::Hris::PaginatedAccountDetailsAndActionsList.from_json(json_object: response.body)
       end
     end
 
     class AsyncLinkedAccountsClient
+      # @return [Merge::AsyncRequestClient]
       attr_reader :request_client
 
-      # @param request_client [AsyncRequestClient]
-      # @return [Hris::AsyncLinkedAccountsClient]
+      # @param request_client [Merge::AsyncRequestClient]
+      # @return [Merge::Hris::AsyncLinkedAccountsClient]
       def initialize(request_client:)
-        # @type [AsyncRequestClient]
         @request_client = request_client
       end
 
       # List linked accounts for your organization.
       #
-      # @param category [LINKED_ACCOUNTS_LIST_REQUEST_CATEGORY] Options: ('hris', 'ats', 'accounting', 'ticketing', 'crm', 'mktg', 'filestorage')
-      #   - `hris` - hris
-      #   - `ats` - ats
-      #   - `accounting` - accounting
-      #   - `ticketing` - ticketing
-      #   - `crm` - crm
-      #   - `mktg` - mktg
-      #   - `filestorage` - filestorage
+      # @param category [Merge::Hris::LinkedAccounts::LinkedAccountsListRequestCategory] Options: ('hris', 'ats', 'accounting', 'ticketing', 'crm', 'mktg',
+      #  'filestorage')
+      #  - `hris` - hris
+      #  - `ats` - ats
+      #  - `accounting` - accounting
+      #  - `ticketing` - ticketing
+      #  - `crm` - crm
+      #  - `mktg` - mktg
+      #  - `filestorage` - filestorage
       # @param cursor [String] The pagination cursor value.
-      # @param end_user_email_address [String] If provided, will only return linked accounts associated with the given email address.
-      # @param end_user_organization_name [String] If provided, will only return linked accounts associated with the given organization name.
-      # @param end_user_origin_id [String] If provided, will only return linked accounts associated with the given origin ID.
-      # @param end_user_origin_ids [String] Comma-separated list of EndUser origin IDs, making it possible to specify multiple EndUsers at once.
+      # @param end_user_email_address [String] If provided, will only return linked accounts associated with the given email
+      #  address.
+      # @param end_user_organization_name [String] If provided, will only return linked accounts associated with the given
+      #  organization name.
+      # @param end_user_origin_id [String] If provided, will only return linked accounts associated with the given origin
+      #  ID.
+      # @param end_user_origin_ids [String] Comma-separated list of EndUser origin IDs, making it possible to specify
+      #  multiple EndUsers at once.
       # @param id [String]
-      # @param ids [String] Comma-separated list of LinkedAccount IDs, making it possible to specify multiple LinkedAccounts at once.
-      # @param include_duplicates [Boolean] If `true`, will include complete production duplicates of the account specified by the `id` query parameter in the response. `id` must be for a complete production linked account.
-      # @param integration_name [String] If provided, will only return linked accounts associated with the given integration name.
-      # @param is_test_account [String] If included, will only include test linked accounts. If not included, will only include non-test linked accounts.
+      # @param ids [String] Comma-separated list of LinkedAccount IDs, making it possible to specify
+      #  multiple LinkedAccounts at once.
+      # @param include_duplicates [Boolean] If `true`, will include complete production duplicates of the account specified
+      #  by the `id` query parameter in the response. `id` must be for a complete
+      #  production linked account.
+      # @param integration_name [String] If provided, will only return linked accounts associated with the given
+      #  integration name.
+      # @param is_test_account [String] If included, will only include test linked accounts. If not included, will only
+      #  include non-test linked accounts.
       # @param page_size [Integer] Number of results to return per page.
       # @param status [String] Filter by status. Options: `COMPLETE`, `INCOMPLETE`, `RELINK_NEEDED`
-      # @param request_options [RequestOptions]
-      # @return [Hris::PaginatedAccountDetailsAndActionsList]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::PaginatedAccountDetailsAndActionsList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.list
       def list(category: nil, cursor: nil, end_user_email_address: nil, end_user_organization_name: nil,
                end_user_origin_id: nil, end_user_origin_ids: nil, id: nil, ids: nil, include_duplicates: nil, integration_name: nil, is_test_account: nil, page_size: nil, status: nil, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/hris/v1/linked-accounts") do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -127,8 +162,9 @@ module Merge
               "page_size": page_size,
               "status": status
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/linked-accounts"
           end
-          Hris::PaginatedAccountDetailsAndActionsList.from_json(json_object: response.body)
+          Merge::Hris::PaginatedAccountDetailsAndActionsList.from_json(json_object: response.body)
         end
       end
     end

data/lib/merge_ruby_client/hris/linked_accounts/types/linked_accounts_list_request_category.rb

@@ -3,16 +3,15 @@
 module Merge
   module Hris
     class LinkedAccounts
-      # @type [LINKED_ACCOUNTS_LIST_REQUEST_CATEGORY]
-      LINKED_ACCOUNTS_LIST_REQUEST_CATEGORY = {
-        accounting: "accounting",
-        ats: "ats",
-        crm: "crm",
-        filestorage: "filestorage",
-        hris: "hris",
-        mktg: "mktg",
-        ticketing: "ticketing"
-      }.freeze
+      class LinkedAccountsListRequestCategory
+        ACCOUNTING = "accounting"
+        ATS = "ats"
+        CRM = "crm"
+        FILESTORAGE = "filestorage"
+        HRIS = "hris"
+        MKTG = "mktg"
+        TICKETING = "ticketing"
+      end
     end
   end
 end

data/lib/merge_ruby_client/hris/locations/client.rb

@@ -10,12 +10,12 @@ require "async"
 module Merge
   module Hris
     class LocationsClient
+      # @return [Merge::RequestClient]
       attr_reader :request_client
 
-      # @param request_client [RequestClient]
-      # @return [Hris::LocationsClient]
+      # @param request_client [Merge::RequestClient]
+      # @return [Merge::Hris::LocationsClient]
       def initialize(request_client:)
-        # @type [RequestClient]
         @request_client = request_client
       end
 
@@ -25,21 +25,32 @@ module Merge
       # @param created_before [DateTime] If provided, will only return objects created before this datetime.
       # @param cursor [String] The pagination cursor value.
       # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
-      # @param location_type [LOCATIONS_LIST_REQUEST_LOCATION_TYPE] If provided, will only return locations with this location_type
-      #   - `HOME` - HOME
-      #   - `WORK` - WORK
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param location_type [Merge::Hris::Locations::LocationsListRequestLocationType] If provided, will only return locations with this location_type
+      #  - `HOME` - HOME
+      #  - `WORK` - WORK
       # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
-      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be returned.
+      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be
+      #  returned.
       # @param page_size [Integer] Number of results to return per page.
       # @param remote_fields [String] Deprecated. Use show_enum_origins.
       # @param remote_id [String] The API provider's ID for the given object.
-      # @param show_enum_origins [String] Which fields should be returned in non-normalized form.
-      # @param request_options [RequestOptions]
-      # @return [Hris::PaginatedLocationList]
+      # @param show_enum_origins [String] A comma separated list of enum field names for which you'd like the original
+      #  values to be returned, instead of Merge's normalized enum values. [Learn
+      #  e](https://help.merge.dev/en/articles/8950958-show_enum_origins-query-parameter)
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::PaginatedLocationList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.list
       def list(created_after: nil, created_before: nil, cursor: nil, include_deleted_data: nil,
                include_remote_data: nil, location_type: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_fields: nil, remote_id: nil, show_enum_origins: nil, request_options: nil)
-        response = @request_client.conn.get("/api/hris/v1/locations") do |req|
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -59,20 +70,31 @@ module Merge
             "remote_id": remote_id,
             "show_enum_origins": show_enum_origins
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/locations"
         end
-        Hris::PaginatedLocationList.from_json(json_object: response.body)
+        Merge::Hris::PaginatedLocationList.from_json(json_object: response.body)
       end
 
       # Returns a `Location` object with the given `id`.
       #
       # @param id [String]
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
       # @param remote_fields [String] Deprecated. Use show_enum_origins.
-      # @param show_enum_origins [String] Which fields should be returned in non-normalized form.
-      # @param request_options [RequestOptions]
-      # @return [Hris::Location]
+      # @param show_enum_origins [String] A comma separated list of enum field names for which you'd like the original
+      #  values to be returned, instead of Merge's normalized enum values. [Learn
+      #  e](https://help.merge.dev/en/articles/8950958-show_enum_origins-query-parameter)
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::Location]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.retrieve(id: "id")
       def retrieve(id:, include_remote_data: nil, remote_fields: nil, show_enum_origins: nil, request_options: nil)
-        response = @request_client.conn.get("/api/hris/v1/locations/#{id}") do |req|
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -83,18 +105,19 @@ module Merge
             "remote_fields": remote_fields,
             "show_enum_origins": show_enum_origins
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/locations/#{id}"
         end
-        Hris::Location.from_json(json_object: response.body)
+        Merge::Hris::Location.from_json(json_object: response.body)
       end
     end
 
     class AsyncLocationsClient
+      # @return [Merge::AsyncRequestClient]
       attr_reader :request_client
 
-      # @param request_client [AsyncRequestClient]
-      # @return [Hris::AsyncLocationsClient]
+      # @param request_client [Merge::AsyncRequestClient]
+      # @return [Merge::Hris::AsyncLocationsClient]
       def initialize(request_client:)
-        # @type [AsyncRequestClient]
         @request_client = request_client
       end
 
@@ -104,22 +127,33 @@ module Merge
       # @param created_before [DateTime] If provided, will only return objects created before this datetime.
       # @param cursor [String] The pagination cursor value.
       # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
-      # @param location_type [LOCATIONS_LIST_REQUEST_LOCATION_TYPE] If provided, will only return locations with this location_type
-      #   - `HOME` - HOME
-      #   - `WORK` - WORK
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param location_type [Merge::Hris::Locations::LocationsListRequestLocationType] If provided, will only return locations with this location_type
+      #  - `HOME` - HOME
+      #  - `WORK` - WORK
       # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
-      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be returned.
+      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be
+      #  returned.
       # @param page_size [Integer] Number of results to return per page.
       # @param remote_fields [String] Deprecated. Use show_enum_origins.
       # @param remote_id [String] The API provider's ID for the given object.
-      # @param show_enum_origins [String] Which fields should be returned in non-normalized form.
-      # @param request_options [RequestOptions]
-      # @return [Hris::PaginatedLocationList]
+      # @param show_enum_origins [String] A comma separated list of enum field names for which you'd like the original
+      #  values to be returned, instead of Merge's normalized enum values. [Learn
+      #  e](https://help.merge.dev/en/articles/8950958-show_enum_origins-query-parameter)
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::PaginatedLocationList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.list
       def list(created_after: nil, created_before: nil, cursor: nil, include_deleted_data: nil,
                include_remote_data: nil, location_type: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_fields: nil, remote_id: nil, show_enum_origins: nil, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/hris/v1/locations") do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -139,22 +173,33 @@ module Merge
               "remote_id": remote_id,
               "show_enum_origins": show_enum_origins
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/locations"
           end
-          Hris::PaginatedLocationList.from_json(json_object: response.body)
+          Merge::Hris::PaginatedLocationList.from_json(json_object: response.body)
         end
       end
 
       # Returns a `Location` object with the given `id`.
       #
       # @param id [String]
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
       # @param remote_fields [String] Deprecated. Use show_enum_origins.
-      # @param show_enum_origins [String] Which fields should be returned in non-normalized form.
-      # @param request_options [RequestOptions]
-      # @return [Hris::Location]
+      # @param show_enum_origins [String] A comma separated list of enum field names for which you'd like the original
+      #  values to be returned, instead of Merge's normalized enum values. [Learn
+      #  e](https://help.merge.dev/en/articles/8950958-show_enum_origins-query-parameter)
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::Location]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.retrieve(id: "id")
       def retrieve(id:, include_remote_data: nil, remote_fields: nil, show_enum_origins: nil, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/hris/v1/locations/#{id}") do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -165,8 +210,9 @@ module Merge
               "remote_fields": remote_fields,
               "show_enum_origins": show_enum_origins
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/locations/#{id}"
           end
-          Hris::Location.from_json(json_object: response.body)
+          Merge::Hris::Location.from_json(json_object: response.body)
         end
       end
     end

data/lib/merge_ruby_client/hris/locations/types/locations_list_request_location_type.rb

@@ -3,8 +3,10 @@
 module Merge
   module Hris
     class Locations
-      # @type [LOCATIONS_LIST_REQUEST_LOCATION_TYPE]
-      LOCATIONS_LIST_REQUEST_LOCATION_TYPE = { home: "HOME", work: "WORK" }.freeze
+      class LocationsListRequestLocationType
+        HOME = "HOME"
+        WORK = "WORK"
+      end
     end
   end
 end