docusign_rooms 1.0.0.beta → 1.2.0.rc1

data/lib/docusign_rooms/api/roles_api.rb

@@ -14,7 +14,7 @@ require "uri"
 module DocuSign_Rooms
 
   class GetRoleOptions
-    # 
+    # When set to true, the response includes the `isAssigned` property, which specifies whether the role is currently assigned to any users. The default is false.
     attr_accessor :include_is_assigned
 
     def self.default
@@ -23,16 +23,19 @@ module DocuSign_Rooms
   end
 
   class GetRolesOptions
-    # 
+    # Returns assignable roles based on calling user's company permissions.               DEPRECATED: Please use filterContext parameter to get the assignable roles. AssignableRolesBasedOnCompanyPermissions returns same results as onlyAssignable=true
     attr_accessor :only_assignable
 
-    # 
+    # Attribute establishing filter context for roles being returned - AllRoles, AssignableRolesBasedOnCompanyPermissions, AssignableRolesBasedOnAllPermissions
+    attr_accessor :filter_context
+
+    # A search filter that returns roles by the beginning of the role name. You can enter the beginning of the role name only to return all of the roles that begin with the text that you entered.
     attr_accessor :filter
 
-    # 
+    # The starting zero-based index position of the result set. The default value is 0.
     attr_accessor :start_position
 
-    # 
+    # The number of results to return. This value must be a number between `1` and `100` (default).
     attr_accessor :count
 
     def self.default
@@ -49,26 +52,24 @@ module DocuSign_Rooms
     end
 
     # Creates a role.
-    # 
-    # @param account_id 
-    # @param role  
+    # Creates a new company role in Rooms
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
+    # @param body  (optional parameter)
     # @return [Role]
-    def create_role(account_id, role)
-      data, _status_code, _headers = create_role_with_http_info(account_id,  role)
+    def create_role(account_id, body)
+      data, _status_code, _headers = create_role_with_http_info(account_id,  body)
       return data
     end
 
     # Creates a role.
-    # 
-    # @param account_id 
-    # @param role  
+    # Creates a new company role in Rooms
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
+    # @param body  (optional parameter)
     # @return [Array<(Role, Fixnum, Hash)>] Role data, response status code and response headers
-    def create_role_with_http_info(account_id, role)
+    def create_role_with_http_info(account_id, body)
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: RolesApi.create_role ..."
       end
-      # verify the required parameter 'role' is set
-      fail ArgumentError, "Missing the required parameter 'role' when calling RolesApi.create_role" if role.nil?
       # verify the required parameter 'account_id' is set
       fail ArgumentError, "Missing the required parameter 'account_id' when calling RolesApi.create_role" if account_id.nil?
       # resource path
@@ -80,15 +81,15 @@ module DocuSign_Rooms
       # header parameters
       header_params = {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['text/plain', 'application/json', 'text/json'])
       # HTTP header 'Content-Type'
-      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json-patch+json', 'application/json', 'text/json', 'application/*+json'])
 
       # form parameters
       form_params = {}
 
       # http body (model)
-      post_body = @api_client.object_to_http_body(role)
+      post_body = @api_client.object_to_http_body(body)
       auth_names = []
       data, status_code, headers = @api_client.call_api(:POST, local_var_path,
         :header_params => header_params,
@@ -104,9 +105,9 @@ module DocuSign_Rooms
     end
 
     # Deletes the role with the given roleId.
-    # 
-    # @param role_id 
-    # @param account_id 
+    # Deletes a role from a company account in Rooms
+    # @param role_id The id of the role.
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
     # @return [nil]
     def delete_role(role_id, account_id)
       delete_role_with_http_info(role_id, account_id)
@@ -114,9 +115,9 @@ module DocuSign_Rooms
     end
 
     # Deletes the role with the given roleId.
-    # 
-    # @param role_id 
-    # @param account_id 
+    # Deletes a role from a company account in Rooms
+    # @param role_id The id of the role.
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
     # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
     def delete_role_with_http_info(role_id, account_id)
       if @api_client.config.debugging
@@ -135,7 +136,9 @@ module DocuSign_Rooms
       # header parameters
       header_params = {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['text/plain', 'application/json', 'text/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json-patch+json', 'application/json', 'text/json', 'application/*+json'])
 
       # form parameters
       form_params = {}
@@ -156,9 +159,9 @@ module DocuSign_Rooms
     end
 
     # Get information about the role with the given roleId.
-    # 
-    # @param role_id 
-    # @param account_id 
+    # Get information about the role with the given roleId.
+    # @param role_id The id of the role.
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
     # @param DocuSign_Rooms::GetRoleOptions Options for modifying the behavior of the function.
     # @return [Role]
     def get_role(role_id, account_id, options = DocuSign_Rooms::GetRoleOptions.default)
@@ -167,9 +170,9 @@ module DocuSign_Rooms
     end
 
     # Get information about the role with the given roleId.
-    # 
-    # @param role_id 
-    # @param account_id 
+    # Get information about the role with the given roleId.
+    # @param role_id The id of the role.
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
     # @param DocuSign_Rooms::GetRoleOptions Options for modifying the behavior of the function.
     # @return [Array<(Role, Fixnum, Hash)>] Role data, response status code and response headers
     def get_role_with_http_info(role_id, account_id, options = DocuSign_Rooms::GetRoleOptions.default)
@@ -190,7 +193,9 @@ module DocuSign_Rooms
       # header parameters
       header_params = {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['text/plain', 'application/json', 'text/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json-patch+json', 'application/json', 'text/json', 'application/*+json'])
 
       # form parameters
       form_params = {}
@@ -212,8 +217,8 @@ module DocuSign_Rooms
     end
 
     # Gets a paged-list of roles in your company
-    # 
-    # @param account_id 
+    # Returns a list of roles associated with a company account
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
     # @param DocuSign_Rooms::GetRolesOptions Options for modifying the behavior of the function.
     # @return [RoleSummaryList]
     def get_roles(account_id, options = DocuSign_Rooms::GetRolesOptions.default)
@@ -222,8 +227,8 @@ module DocuSign_Rooms
     end
 
     # Gets a paged-list of roles in your company
-    # 
-    # @param account_id 
+    # Returns a list of roles associated with a company account
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
     # @param DocuSign_Rooms::GetRolesOptions Options for modifying the behavior of the function.
     # @return [Array<(RoleSummaryList, Fixnum, Hash)>] RoleSummaryList data, response status code and response headers
     def get_roles_with_http_info(account_id, options = DocuSign_Rooms::GetRolesOptions.default)
@@ -232,12 +237,16 @@ module DocuSign_Rooms
       end
       # verify the required parameter 'account_id' is set
       fail ArgumentError, "Missing the required parameter 'account_id' when calling RolesApi.get_roles" if account_id.nil?
+      if options.filter_context && !['AllRoles', 'AssignableRolesBasedOnCompanyPermissions', 'AssignableRolesBasedOnAllPermissions'].include?(options.filter_context)
+        fail ArgumentError, 'invalid value for "filter_context", must be one of AllRoles, AssignableRolesBasedOnCompanyPermissions, AssignableRolesBasedOnAllPermissions'
+      end
       # resource path
       local_var_path = "/v2/accounts/{accountId}/roles".sub('{format}','json').sub('{' + 'accountId' + '}', account_id.to_s)
 
       # query parameters
       query_params = {}
       query_params[:'onlyAssignable'] = options.only_assignable if !options.only_assignable.nil?
+      query_params[:'filterContext'] = options.filter_context if !options.filter_context.nil?
       query_params[:'filter'] = options.filter if !options.filter.nil?
       query_params[:'startPosition'] = options.start_position if !options.start_position.nil?
       query_params[:'count'] = options.count if !options.count.nil?
@@ -245,7 +254,9 @@ module DocuSign_Rooms
       # header parameters
       header_params = {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['text/plain', 'application/json', 'text/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json-patch+json', 'application/json', 'text/json', 'application/*+json'])
 
       # form parameters
       form_params = {}
@@ -267,30 +278,28 @@ module DocuSign_Rooms
     end
 
     # Updates the role with the given roleId.
-    # 
-    # @param role_id 
-    # @param account_id 
-    # @param role  
+    # Updates the role with the given roleId.
+    # @param role_id The id of the role.
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
+    # @param body  (optional parameter)
     # @return [Role]
-    def update_role(role_id, account_id, role)
-      data, _status_code, _headers = update_role_with_http_info(role_id, account_id,  role)
+    def update_role(role_id, account_id, body)
+      data, _status_code, _headers = update_role_with_http_info(role_id, account_id,  body)
       return data
     end
 
     # Updates the role with the given roleId.
-    # 
-    # @param role_id 
-    # @param account_id 
-    # @param role  
+    # Updates the role with the given roleId.
+    # @param role_id The id of the role.
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
+    # @param body  (optional parameter)
     # @return [Array<(Role, Fixnum, Hash)>] Role data, response status code and response headers
-    def update_role_with_http_info(role_id, account_id, role)
+    def update_role_with_http_info(role_id, account_id, body)
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: RolesApi.update_role ..."
       end
       # verify the required parameter 'role_id' is set
       fail ArgumentError, "Missing the required parameter 'role_id' when calling RolesApi.update_role" if role_id.nil?
-      # verify the required parameter 'role' is set
-      fail ArgumentError, "Missing the required parameter 'role' when calling RolesApi.update_role" if role.nil?
       # verify the required parameter 'account_id' is set
       fail ArgumentError, "Missing the required parameter 'account_id' when calling RolesApi.update_role" if account_id.nil?
       # resource path
@@ -302,15 +311,15 @@ module DocuSign_Rooms
       # header parameters
       header_params = {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['text/plain', 'application/json', 'text/json'])
       # HTTP header 'Content-Type'
-      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json-patch+json', 'application/json', 'text/json', 'application/*+json'])
 
       # form parameters
       form_params = {}
 
       # http body (model)
-      post_body = @api_client.object_to_http_body(role)
+      post_body = @api_client.object_to_http_body(body)
       auth_names = []
       data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
         :header_params => header_params,

data/lib/docusign_rooms/api/room_contact_types_api.rb

@@ -22,7 +22,7 @@ module DocuSign_Rooms
     end
 
     # Retrieves the list of valid room contact types.
-    # 
+    # Returns a list of room contact types, such as Buyer, Seller, and Listing Agent.
     # @return [GlobalRoomContactTypes]
     def get_room_contact_types()
       data, _status_code, _headers = get_room_contact_types_with_http_info()
@@ -30,7 +30,7 @@ module DocuSign_Rooms
     end
 
     # Retrieves the list of valid room contact types.
-    # 
+    # Returns a list of room contact types, such as Buyer, Seller, and Listing Agent.
     # @return [Array<(GlobalRoomContactTypes, Fixnum, Hash)>] GlobalRoomContactTypes data, response status code and response headers
     def get_room_contact_types_with_http_info()
       if @api_client.config.debugging
@@ -45,7 +45,9 @@ module DocuSign_Rooms
       # header parameters
       header_params = {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['text/plain', 'application/json', 'text/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json-patch+json', 'application/json', 'text/json', 'application/*+json'])
 
       # form parameters
       form_params = {}

data/lib/docusign_rooms/api/room_folders_api.rb

@@ -34,9 +34,9 @@ module DocuSign_Rooms
     end
 
     # Gets room folders accessible to the calling user.
-    # 
+    # Gets a list of room folders in the specified room that are accessible to the current user.
     # @param room_id The room id from which to retrieve folders.
-    # @param account_id 
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
     # @param DocuSign_Rooms::GetRoomFoldersOptions Options for modifying the behavior of the function.
     # @return [RoomFolderList]
     def get_room_folders(room_id, account_id, options = DocuSign_Rooms::GetRoomFoldersOptions.default)
@@ -45,9 +45,9 @@ module DocuSign_Rooms
     end
 
     # Gets room folders accessible to the calling user.
-    # 
+    # Gets a list of room folders in the specified room that are accessible to the current user.
     # @param room_id The room id from which to retrieve folders.
-    # @param account_id 
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
     # @param DocuSign_Rooms::GetRoomFoldersOptions Options for modifying the behavior of the function.
     # @return [Array<(RoomFolderList, Fixnum, Hash)>] RoomFolderList data, response status code and response headers
     def get_room_folders_with_http_info(room_id, account_id, options = DocuSign_Rooms::GetRoomFoldersOptions.default)
@@ -69,7 +69,9 @@ module DocuSign_Rooms
       # header parameters
       header_params = {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['text/plain', 'application/json', 'text/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json-patch+json', 'application/json', 'text/json', 'application/*+json'])
 
       # form parameters
       form_params = {}

data/lib/docusign_rooms/api/room_templates_api.rb

@@ -20,6 +20,9 @@ module DocuSign_Rooms
     # Get list of templates you have access to. Default value false.
     attr_accessor :only_assignable
 
+    # When set to true, only returns room templates that are not disabled.
+    attr_accessor :only_enabled
+
     # Number of room templates to return. Defaults to the maximum which is 100.
     attr_accessor :count
 
@@ -40,8 +43,8 @@ module DocuSign_Rooms
     end
 
     # Returns all room templates that the active user has access to
-    # 
-    # @param account_id 
+    # This method returns a list of room templates that the user can use to create a new room. The response includes company and region-level templates
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
     # @param DocuSign_Rooms::GetRoomTemplatesOptions Options for modifying the behavior of the function.
     # @return [RoomTemplatesSummaryList]
     def get_room_templates(account_id, options = DocuSign_Rooms::GetRoomTemplatesOptions.default)
@@ -50,8 +53,8 @@ module DocuSign_Rooms
     end
 
     # Returns all room templates that the active user has access to
-    # 
-    # @param account_id 
+    # This method returns a list of room templates that the user can use to create a new room. The response includes company and region-level templates
+    # @param account_id (Required) The globally unique identifier (GUID) for the account.
     # @param DocuSign_Rooms::GetRoomTemplatesOptions Options for modifying the behavior of the function.
     # @return [Array<(RoomTemplatesSummaryList, Fixnum, Hash)>] RoomTemplatesSummaryList data, response status code and response headers
     def get_room_templates_with_http_info(account_id, options = DocuSign_Rooms::GetRoomTemplatesOptions.default)
@@ -67,13 +70,16 @@ module DocuSign_Rooms
       query_params = {}
       query_params[:'officeId'] = options.office_id if !options.office_id.nil?
       query_params[:'onlyAssignable'] = options.only_assignable if !options.only_assignable.nil?
+      query_params[:'onlyEnabled'] = options.only_enabled if !options.only_enabled.nil?
       query_params[:'count'] = options.count if !options.count.nil?
       query_params[:'startPosition'] = options.start_position if !options.start_position.nil?
 
       # header parameters
       header_params = {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['text/plain', 'application/json', 'text/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json-patch+json', 'application/json', 'text/json', 'application/*+json'])
 
       # form parameters
       form_params = {}