merge_ruby_client 0.0.3 → 0.1.0

data/lib/merge_ruby_client/filestorage/groups/client.rb

@@ -9,12 +9,12 @@ require "async"
 module Merge
   module Filestorage
     class GroupsClient
+      # @return [Merge::RequestClient]
       attr_reader :request_client
 
-      # @param request_client [RequestClient]
-      # @return [Filestorage::GroupsClient]
+      # @param request_client [Merge::RequestClient]
+      # @return [Merge::Filestorage::GroupsClient]
       def initialize(request_client:)
-        # @type [RequestClient]
         @request_client = request_client
       end
 
@@ -24,16 +24,25 @@ 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 include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
       # @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_id [String] The API provider's ID for the given object.
-      # @param request_options [RequestOptions]
-      # @return [Filestorage::PaginatedGroupList]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::PaginatedGroupList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.list
       def list(created_after: nil, created_before: nil, cursor: nil, include_deleted_data: nil,
                include_remote_data: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_id: nil, request_options: nil)
-        response = @request_client.conn.get("/api/filestorage/v1/groups") 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?
@@ -50,18 +59,27 @@ module Merge
             "page_size": page_size,
             "remote_id": remote_id
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/groups"
         end
-        Filestorage::PaginatedGroupList.from_json(json_object: response.body)
+        Merge::Filestorage::PaginatedGroupList.from_json(json_object: response.body)
       end
 
       # Returns a `Group` 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 request_options [RequestOptions]
-      # @return [Filestorage::Group]
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::Group]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.retrieve(id: "id")
       def retrieve(id:, include_remote_data: nil, request_options: nil)
-        response = @request_client.conn.get("/api/filestorage/v1/groups/#{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?
@@ -70,18 +88,19 @@ module Merge
             **(request_options&.additional_query_parameters || {}),
             "include_remote_data": include_remote_data
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/groups/#{id}"
         end
-        Filestorage::Group.from_json(json_object: response.body)
+        Merge::Filestorage::Group.from_json(json_object: response.body)
       end
     end
 
     class AsyncGroupsClient
+      # @return [Merge::AsyncRequestClient]
       attr_reader :request_client
 
-      # @param request_client [AsyncRequestClient]
-      # @return [Filestorage::AsyncGroupsClient]
+      # @param request_client [Merge::AsyncRequestClient]
+      # @return [Merge::Filestorage::AsyncGroupsClient]
       def initialize(request_client:)
-        # @type [AsyncRequestClient]
         @request_client = request_client
       end
 
@@ -91,17 +110,26 @@ 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 include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
       # @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_id [String] The API provider's ID for the given object.
-      # @param request_options [RequestOptions]
-      # @return [Filestorage::PaginatedGroupList]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::PaginatedGroupList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.list
       def list(created_after: nil, created_before: nil, cursor: nil, include_deleted_data: nil,
                include_remote_data: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_id: nil, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/filestorage/v1/groups") 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?
@@ -118,20 +146,29 @@ module Merge
               "page_size": page_size,
               "remote_id": remote_id
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/groups"
           end
-          Filestorage::PaginatedGroupList.from_json(json_object: response.body)
+          Merge::Filestorage::PaginatedGroupList.from_json(json_object: response.body)
         end
       end
 
       # Returns a `Group` 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 request_options [RequestOptions]
-      # @return [Filestorage::Group]
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::Group]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.retrieve(id: "id")
       def retrieve(id:, include_remote_data: nil, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/filestorage/v1/groups/#{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?
@@ -140,8 +177,9 @@ module Merge
               **(request_options&.additional_query_parameters || {}),
               "include_remote_data": include_remote_data
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/groups/#{id}"
           end
-          Filestorage::Group.from_json(json_object: response.body)
+          Merge::Filestorage::Group.from_json(json_object: response.body)
         end
       end
     end

data/lib/merge_ruby_client/filestorage/issues/client.rb

@@ -10,12 +10,12 @@ require "async"
 module Merge
   module Filestorage
     class IssuesClient
+      # @return [Merge::RequestClient]
       attr_reader :request_client
 
-      # @param request_client [RequestClient]
-      # @return [Filestorage::IssuesClient]
+      # @param request_client [Merge::RequestClient]
+      # @return [Merge::Filestorage::IssuesClient]
       def initialize(request_client:)
-        # @type [RequestClient]
         @request_client = request_client
       end
 
@@ -23,24 +23,37 @@ module Merge
       #
       # @param account_token [String]
       # @param cursor [String] The pagination cursor value.
-      # @param end_date [String] If included, will only include issues whose most recent action occurred before this time
+      # @param end_date [String] If included, will only include issues whose most recent action occurred before
+      #  this time
       # @param end_user_organization_name [String]
-      # @param first_incident_time_after [DateTime] If provided, will only return issues whose first incident time was after this datetime.
-      # @param first_incident_time_before [DateTime] If provided, will only return issues whose first incident time was before this datetime.
-      # @param include_muted [String] If True, will include muted issues
+      # @param first_incident_time_after [DateTime] If provided, will only return issues whose first incident time was after this
+      #  datetime.
+      # @param first_incident_time_before [DateTime] If provided, will only return issues whose first incident time was before this
+      #  datetime.
+      # @param include_muted [String] If true, will include muted issues
       # @param integration_name [String]
-      # @param last_incident_time_after [DateTime] If provided, will only return issues whose last incident time was after this datetime.
-      # @param last_incident_time_before [DateTime] If provided, will only return issues whose last incident time was before this datetime.
+      # @param last_incident_time_after [DateTime] If provided, will only return issues whose last incident time was after this
+      #  datetime.
+      # @param last_incident_time_before [DateTime] If provided, will only return issues whose last incident time was before this
+      #  datetime.
       # @param page_size [Integer] Number of results to return per page.
-      # @param start_date [String] If included, will only include issues whose most recent action occurred after this time
-      # @param status [ISSUES_LIST_REQUEST_STATUS] Status of the issue. Options: ('ONGOING', 'RESOLVED')
-      #   - `ONGOING` - ONGOING
-      #   - `RESOLVED` - RESOLVED
-      # @param request_options [RequestOptions]
-      # @return [Filestorage::PaginatedIssueList]
+      # @param start_date [String] If included, will only include issues whose most recent action occurred after
+      #  this time
+      # @param status [Merge::Filestorage::Issues::IssuesListRequestStatus] Status of the issue. Options: ('ONGOING', 'RESOLVED')
+      #  - `ONGOING` - ONGOING
+      #  - `RESOLVED` - RESOLVED
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::PaginatedIssueList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.list
       def list(account_token: nil, cursor: nil, end_date: nil, end_user_organization_name: nil,
                first_incident_time_after: nil, first_incident_time_before: nil, include_muted: nil, integration_name: nil, last_incident_time_after: nil, last_incident_time_before: nil, page_size: nil, start_date: nil, status: nil, request_options: nil)
-        response = @request_client.conn.get("/api/filestorage/v1/issues") 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?
@@ -61,33 +74,42 @@ module Merge
             "start_date": start_date,
             "status": status
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/issues"
         end
-        Filestorage::PaginatedIssueList.from_json(json_object: response.body)
+        Merge::Filestorage::PaginatedIssueList.from_json(json_object: response.body)
       end
 
       # Get a specific issue.
       #
       # @param id [String]
-      # @param request_options [RequestOptions]
-      # @return [Filestorage::Issue]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::Issue]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.retrieve(id: "id")
       def retrieve(id:, request_options: nil)
-        response = @request_client.conn.get("/api/filestorage/v1/issues/#{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?
           req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/issues/#{id}"
         end
-        Filestorage::Issue.from_json(json_object: response.body)
+        Merge::Filestorage::Issue.from_json(json_object: response.body)
       end
     end
 
     class AsyncIssuesClient
+      # @return [Merge::AsyncRequestClient]
       attr_reader :request_client
 
-      # @param request_client [AsyncRequestClient]
-      # @return [Filestorage::AsyncIssuesClient]
+      # @param request_client [Merge::AsyncRequestClient]
+      # @return [Merge::Filestorage::AsyncIssuesClient]
       def initialize(request_client:)
-        # @type [AsyncRequestClient]
         @request_client = request_client
       end
 
@@ -95,25 +117,38 @@ module Merge
       #
       # @param account_token [String]
       # @param cursor [String] The pagination cursor value.
-      # @param end_date [String] If included, will only include issues whose most recent action occurred before this time
+      # @param end_date [String] If included, will only include issues whose most recent action occurred before
+      #  this time
       # @param end_user_organization_name [String]
-      # @param first_incident_time_after [DateTime] If provided, will only return issues whose first incident time was after this datetime.
-      # @param first_incident_time_before [DateTime] If provided, will only return issues whose first incident time was before this datetime.
-      # @param include_muted [String] If True, will include muted issues
+      # @param first_incident_time_after [DateTime] If provided, will only return issues whose first incident time was after this
+      #  datetime.
+      # @param first_incident_time_before [DateTime] If provided, will only return issues whose first incident time was before this
+      #  datetime.
+      # @param include_muted [String] If true, will include muted issues
       # @param integration_name [String]
-      # @param last_incident_time_after [DateTime] If provided, will only return issues whose last incident time was after this datetime.
-      # @param last_incident_time_before [DateTime] If provided, will only return issues whose last incident time was before this datetime.
+      # @param last_incident_time_after [DateTime] If provided, will only return issues whose last incident time was after this
+      #  datetime.
+      # @param last_incident_time_before [DateTime] If provided, will only return issues whose last incident time was before this
+      #  datetime.
       # @param page_size [Integer] Number of results to return per page.
-      # @param start_date [String] If included, will only include issues whose most recent action occurred after this time
-      # @param status [ISSUES_LIST_REQUEST_STATUS] Status of the issue. Options: ('ONGOING', 'RESOLVED')
-      #   - `ONGOING` - ONGOING
-      #   - `RESOLVED` - RESOLVED
-      # @param request_options [RequestOptions]
-      # @return [Filestorage::PaginatedIssueList]
+      # @param start_date [String] If included, will only include issues whose most recent action occurred after
+      #  this time
+      # @param status [Merge::Filestorage::Issues::IssuesListRequestStatus] Status of the issue. Options: ('ONGOING', 'RESOLVED')
+      #  - `ONGOING` - ONGOING
+      #  - `RESOLVED` - RESOLVED
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::PaginatedIssueList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.list
       def list(account_token: nil, cursor: nil, end_date: nil, end_user_organization_name: nil,
                first_incident_time_after: nil, first_incident_time_before: nil, include_muted: nil, integration_name: nil, last_incident_time_after: nil, last_incident_time_before: nil, page_size: nil, start_date: nil, status: nil, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/filestorage/v1/issues") 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?
@@ -134,25 +169,34 @@ module Merge
               "start_date": start_date,
               "status": status
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/issues"
           end
-          Filestorage::PaginatedIssueList.from_json(json_object: response.body)
+          Merge::Filestorage::PaginatedIssueList.from_json(json_object: response.body)
         end
       end
 
       # Get a specific issue.
       #
       # @param id [String]
-      # @param request_options [RequestOptions]
-      # @return [Filestorage::Issue]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::Issue]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.retrieve(id: "id")
       def retrieve(id:, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/filestorage/v1/issues/#{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?
             req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/issues/#{id}"
           end
-          Filestorage::Issue.from_json(json_object: response.body)
+          Merge::Filestorage::Issue.from_json(json_object: response.body)
         end
       end
     end

data/lib/merge_ruby_client/filestorage/issues/types/issues_list_request_status.rb

@@ -3,8 +3,10 @@
 module Merge
   module Filestorage
     class Issues
-      # @type [ISSUES_LIST_REQUEST_STATUS]
-      ISSUES_LIST_REQUEST_STATUS = { ongoing: "ONGOING", resolved: "RESOLVED" }.freeze
+      class IssuesListRequestStatus
+        ONGOING = "ONGOING"
+        RESOLVED = "RESOLVED"
+      end
     end
   end
 end

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

@@ -9,33 +9,60 @@ require "async"
 module Merge
   module Filestorage
     class LinkTokenClient
+      # @return [Merge::RequestClient]
       attr_reader :request_client
 
-      # @param request_client [RequestClient]
-      # @return [Filestorage::LinkTokenClient]
+      # @param request_client [Merge::RequestClient]
+      # @return [Merge::Filestorage::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<Filestorage::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<Filestorage::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::Filestorage::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::Filestorage::CommonModelScopesBodyRequest>, as a Hash
       #   * :model_id (String)
-      #   * :enabled_actions (Array<Filestorage::ENABLED_ACTIONS_ENUM>)
+      #   * :enabled_actions (Array<Merge::Filestorage::EnabledActionsEnum>)
       #   * :disabled_fields (Array<String>)
-      # @param request_options [RequestOptions]
-      # @return [Filestorage::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 request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::LinkToken]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.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/filestorage/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, 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 +76,72 @@ 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
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/link-token"
         end
-        Filestorage::LinkToken.from_json(json_object: response.body)
+        Merge::Filestorage::LinkToken.from_json(json_object: response.body)
       end
     end
 
     class AsyncLinkTokenClient
+      # @return [Merge::AsyncRequestClient]
       attr_reader :request_client
 
-      # @param request_client [AsyncRequestClient]
-      # @return [Filestorage::AsyncLinkTokenClient]
+      # @param request_client [Merge::AsyncRequestClient]
+      # @return [Merge::Filestorage::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<Filestorage::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<Filestorage::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::Filestorage::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::Filestorage::CommonModelScopesBodyRequest>, as a Hash
       #   * :model_id (String)
-      #   * :enabled_actions (Array<Filestorage::ENABLED_ACTIONS_ENUM>)
+      #   * :enabled_actions (Array<Merge::Filestorage::EnabledActionsEnum>)
       #   * :disabled_fields (Array<String>)
-      # @param request_options [RequestOptions]
-      # @return [Filestorage::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 request_options [Merge::RequestOptions]
+      # @return [Merge::Filestorage::LinkToken]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.filestorage.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, request_options: nil)
         Async do
-          response = @request_client.conn.post("/api/filestorage/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 +155,13 @@ 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
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/filestorage/v1/link-token"
           end
-          Filestorage::LinkToken.from_json(json_object: response.body)
+          Merge::Filestorage::LinkToken.from_json(json_object: response.body)
         end
       end
     end