docusign_esign 3.17.0 → 3.19.0

data/lib/docusign_esign/api/notary_api.rb

@@ -46,7 +46,7 @@ module DocuSign_eSign
     end
 
     # Add a notary to the system
-    # 
+    # Registers the current user as a notary.
     # @param notary  (optional parameter)
     # @return [Notary]
     def create_notary(notary)
@@ -55,7 +55,7 @@ module DocuSign_eSign
     end
 
     # Add a notary to the system
-    # 
+    # Registers the current user as a notary.
     # @param notary  (optional parameter)
     # @return [Array<(Notary, Fixnum, Hash)>] Notary data, response status code and response headers
     def create_notary_with_http_info(notary)
@@ -93,7 +93,7 @@ module DocuSign_eSign
     end
 
     # Add a notary jurisdiction to the system
-    # 
+    # Creates a jurisdiction object.
     # @param notary_jurisdiction  (optional parameter)
     # @return [NotaryJurisdiction]
     def create_notary_jurisdictions(notary_jurisdiction)
@@ -102,7 +102,7 @@ module DocuSign_eSign
     end
 
     # Add a notary jurisdiction to the system
-    # 
+    # Creates a jurisdiction object.
     # @param notary_jurisdiction  (optional parameter)
     # @return [Array<(NotaryJurisdiction, Fixnum, Hash)>] NotaryJurisdiction data, response status code and response headers
     def create_notary_jurisdictions_with_http_info(notary_jurisdiction)
@@ -140,7 +140,7 @@ module DocuSign_eSign
     end
 
     # Delete a notary jurisdiction a specified user.
-    # 
+    # Deletes the specified jurisdiction.
     # @param jurisdiction_id 
     # @return [nil]
     def delete_notary_jurisdiction(jurisdiction_id)
@@ -149,7 +149,7 @@ module DocuSign_eSign
     end
 
     # Delete a notary jurisdiction a specified user.
-    # 
+    # Deletes the specified jurisdiction.
     # @param jurisdiction_id 
     # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
     def delete_notary_jurisdiction_with_http_info(jurisdiction_id)
@@ -188,7 +188,7 @@ module DocuSign_eSign
     end
 
     # Get notary settings for a user
-    # 
+    # Gets settings for a notary user. The current user must be a notary.
     # @param DocuSign_eSign::GetNotaryOptions Options for modifying the behavior of the function.
     # @return [NotaryResult]
     def get_notary(options = DocuSign_eSign::GetNotaryOptions.default)
@@ -197,7 +197,7 @@ module DocuSign_eSign
     end
 
     # Get notary settings for a user
-    # 
+    # Gets settings for a notary user. The current user must be a notary.
     # @param DocuSign_eSign::GetNotaryOptions Options for modifying the behavior of the function.
     # @return [Array<(NotaryResult, Fixnum, Hash)>] NotaryResult data, response status code and response headers
     def get_notary_with_http_info(options = DocuSign_eSign::GetNotaryOptions.default)
@@ -236,7 +236,7 @@ module DocuSign_eSign
     end
 
     # Get notary a jurisdiction for a user
-    # 
+    # Gets a jurisdiction object for the current user.  The following restrictions apply:  - The current user must be a notary. - The `jurisdictionId` must be a jurisdiction that the notary is registered for. 
     # @param jurisdiction_id 
     # @return [NotaryJurisdiction]
     def get_notary_jurisdiction(jurisdiction_id)
@@ -245,7 +245,7 @@ module DocuSign_eSign
     end
 
     # Get notary a jurisdiction for a user
-    # 
+    # Gets a jurisdiction object for the current user.  The following restrictions apply:  - The current user must be a notary. - The &#x60;jurisdictionId&#x60; must be a jurisdiction that the notary is registered for. 
     # @param jurisdiction_id 
     # @return [Array<(NotaryJurisdiction, Fixnum, Hash)>] NotaryJurisdiction data, response status code and response headers
     def get_notary_jurisdiction_with_http_info(jurisdiction_id)
@@ -333,7 +333,7 @@ module DocuSign_eSign
     end
 
     # Get notary jurisdictions for a user
-    # 
+    # Returns a list of jurisdictions that the notary is registered in. The current user must be a notary.
     # @return [NotaryJurisdictionList]
     def get_notary_jurisdictions()
       data, _status_code, _headers = get_notary_jurisdictions_with_http_info()
@@ -341,7 +341,7 @@ module DocuSign_eSign
     end
 
     # Get notary jurisdictions for a user
-    # 
+    # Returns a list of jurisdictions that the notary is registered in. The current user must be a notary.
     # @return [Array<(NotaryJurisdictionList, Fixnum, Hash)>] NotaryJurisdictionList data, response status code and response headers
     def get_notary_jurisdictions_with_http_info()
       if @api_client.config.debugging
@@ -428,7 +428,7 @@ module DocuSign_eSign
     end
 
     # Update a notary
-    # 
+    # Updates notary information for the current user.
     # @param notary  (optional parameter)
     # @return [Notary]
     def update_notary(notary)
@@ -437,7 +437,7 @@ module DocuSign_eSign
     end
 
     # Update a notary
-    # 
+    # Updates notary information for the current user.
     # @param notary  (optional parameter)
     # @return [Array<(Notary, Fixnum, Hash)>] Notary data, response status code and response headers
     def update_notary_with_http_info(notary)
@@ -475,7 +475,7 @@ module DocuSign_eSign
     end
 
     # Update a notary jurisdiction
-    # 
+    # Updates the jurisdiction information about a notary.  The following restrictions apply:  - The current user must be a notary. - The `jurisdictionId` path parameter must be a jurisdiction that the notary is registered for. - The `jurisdictionId` path parameter must match the request body's `jurisdiction.jurisdictionId`.  The request body must have a full `jurisdiction` object for the jurisdiction property. The best way to do this is to use `getNotaryJurisdiction` to obtain the current values and update the properties you want to change.  For example, assume `getNotaryJurisdiction` returns this:  ``` {     \"jurisdiction\": {         \"jurisdictionId\": \"15\",         \"name\": \"Iowa\",         \"county\": \"\",         \"enabled\": \"true\",         \"countyInSeal\": \"false\",         \"commissionIdInSeal\": \"true\",         \"stateNameInSeal\": \"true\",         \"notaryPublicInSeal\": \"true\",         \"allowSystemCreatedSeal\": \"true\",         \"allowUserUploadedSeal\": \"false\"     },     \"commissionId\": \"123456\",     \"commissionExpiration\": \"2020-08-31T07:00:00.0000000Z\",     \"registeredName\": \"Bob Notary\",     \"county\": \"Adams\",     \"sealType\": \"system_created\" } ```  If you want to change the name of the notary from \"Bob Notary\" to \"Robert Notary\", your request body would be:  ``` {     \"jurisdiction\": {         \"jurisdictionId\": \"15\",         \"name\": \"Iowa\",         \"county\": \"\",         \"enabled\": \"true\",         \"countyInSeal\": \"false\",         \"commissionIdInSeal\": \"true\",         \"stateNameInSeal\": \"true\",         \"notaryPublicInSeal\": \"true\",         \"allowSystemCreatedSeal\": \"true\",         \"allowUserUploadedSeal\": \"false\"     },     \"commissionId\": \"123456\",     \"commissionExpiration\": \"2020-08-31T07:00:00.0000000Z\",     \"registeredName\": \"Robert Notary\",     \"county\": \"Adams\",     \"sealType\": \"system_created\" } ``` 
     # @param jurisdiction_id 
     # @param notary_jurisdiction  (optional parameter)
     # @return [NotaryJurisdiction]
@@ -485,7 +485,7 @@ module DocuSign_eSign
     end
 
     # Update a notary jurisdiction
-    # 
+    # Updates the jurisdiction information about a notary.  The following restrictions apply:  - The current user must be a notary. - The &#x60;jurisdictionId&#x60; path parameter must be a jurisdiction that the notary is registered for. - The &#x60;jurisdictionId&#x60; path parameter must match the request body&#39;s &#x60;jurisdiction.jurisdictionId&#x60;.  The request body must have a full &#x60;jurisdiction&#x60; object for the jurisdiction property. The best way to do this is to use &#x60;getNotaryJurisdiction&#x60; to obtain the current values and update the properties you want to change.  For example, assume &#x60;getNotaryJurisdiction&#x60; returns this:  &#x60;&#x60;&#x60; {     \&quot;jurisdiction\&quot;: {         \&quot;jurisdictionId\&quot;: \&quot;15\&quot;,         \&quot;name\&quot;: \&quot;Iowa\&quot;,         \&quot;county\&quot;: \&quot;\&quot;,         \&quot;enabled\&quot;: \&quot;true\&quot;,         \&quot;countyInSeal\&quot;: \&quot;false\&quot;,         \&quot;commissionIdInSeal\&quot;: \&quot;true\&quot;,         \&quot;stateNameInSeal\&quot;: \&quot;true\&quot;,         \&quot;notaryPublicInSeal\&quot;: \&quot;true\&quot;,         \&quot;allowSystemCreatedSeal\&quot;: \&quot;true\&quot;,         \&quot;allowUserUploadedSeal\&quot;: \&quot;false\&quot;     },     \&quot;commissionId\&quot;: \&quot;123456\&quot;,     \&quot;commissionExpiration\&quot;: \&quot;2020-08-31T07:00:00.0000000Z\&quot;,     \&quot;registeredName\&quot;: \&quot;Bob Notary\&quot;,     \&quot;county\&quot;: \&quot;Adams\&quot;,     \&quot;sealType\&quot;: \&quot;system_created\&quot; } &#x60;&#x60;&#x60;  If you want to change the name of the notary from \&quot;Bob Notary\&quot; to \&quot;Robert Notary\&quot;, your request body would be:  &#x60;&#x60;&#x60; {     \&quot;jurisdiction\&quot;: {         \&quot;jurisdictionId\&quot;: \&quot;15\&quot;,         \&quot;name\&quot;: \&quot;Iowa\&quot;,         \&quot;county\&quot;: \&quot;\&quot;,         \&quot;enabled\&quot;: \&quot;true\&quot;,         \&quot;countyInSeal\&quot;: \&quot;false\&quot;,         \&quot;commissionIdInSeal\&quot;: \&quot;true\&quot;,         \&quot;stateNameInSeal\&quot;: \&quot;true\&quot;,         \&quot;notaryPublicInSeal\&quot;: \&quot;true\&quot;,         \&quot;allowSystemCreatedSeal\&quot;: \&quot;true\&quot;,         \&quot;allowUserUploadedSeal\&quot;: \&quot;false\&quot;     },     \&quot;commissionId\&quot;: \&quot;123456\&quot;,     \&quot;commissionExpiration\&quot;: \&quot;2020-08-31T07:00:00.0000000Z\&quot;,     \&quot;registeredName\&quot;: \&quot;Robert Notary\&quot;,     \&quot;county\&quot;: \&quot;Adams\&quot;,     \&quot;sealType\&quot;: \&quot;system_created\&quot; } &#x60;&#x60;&#x60; 
     # @param jurisdiction_id 
     # @param notary_jurisdiction  (optional parameter)
     # @return [Array<(NotaryJurisdiction, Fixnum, Hash)>] NotaryJurisdiction data, response status code and response headers

data/lib/docusign_esign/api/power_forms_api.rb

@@ -47,6 +47,12 @@ module DocuSign_eSign
     # 
     attr_accessor :order_by
 
+    # 
+    attr_accessor :search_fields
+
+    # 
+    attr_accessor :search_text
+
     # 
     attr_accessor :to_date
 
@@ -64,7 +70,7 @@ module DocuSign_eSign
     end
 
     # Creates a new PowerForm.
-    # 
+    # This method creates a new PowerForm.  You create a PowerForm from an existing DocuSign [template](/docs/esign-rest-api/reference/templates/templates/create/), based on the `templateId` in the request body.   PowerForms that you create from a template are referred to as *web PowerForms*.  **Note:** The DocuSign Admin console also supports creating a PowerForm by uploading a PDF file that has active form fields (referred to as a *PDF PowerForm*). However, PDF PowerForms are deprecated and are not supported in the API.  **Note:** A PowerForm can have only one sender. (Because PowerForms are not necessarily sent by email, this user is also referred to as the PowerForm *initiator*.) If you need to associate multiple senders with a PowerForm, create multiple copies of the PowerForm by using the same template (one copy for each sender). By default, the sender is the PowerForm Administrator who creates the PowerForm.   ### Signing modes  You can use one of the following signing modes for a PowerForm:  **`email`**  This mode verifies the recipient's identity by using email authentication before the recipient can sign a document. The recipient enters their email address on the landing page and then clicks **Begin Signing** to begin the signing process. The system then sends an email message with a validation code to the recipient. If the recipient does not provide a valid email address, they do not receive the email message containing the access code and are not able to open and sign the document.  Alternatively, you can make the process easier for signers by using email authentication only and omitting the access code. To do this, you append the `activateonly` flag to the PowerForm URL and set it to true by passing in the value `1`.  When the flag is active, the first recipient receives an email with a link that initiates the signing session without having to enter access code.  Example: `activateonly=1`  **`direct`**  This mode does not require any verification. After a recipient enters their email address on the landing page and clicks **Begin Signing,** a new browser tab opens and the recipient can immediately begin the signing process.  Because the `direct` signing mode does not verify the recipient's identity by using email authentication, we strongly recommend that you use this mode only when the PowerForm is accessible behind a secure portal where the recipient's identity is already authenticated, or where another form of authentication is specified for the recipient in the DocuSign template (for example, an access code, phone authentication, or ID check).  **Note:** In the account settings, `enablePowerFormDirect` must be **true** to use `direct` as the `signingMode`.  ### Redirect URLs  You can control the URL to which signers are redirected after signing your PowerForm. However, the URL is specified elsewhere, outside of the PowerForm creation process. For details, see [How do I specify a URL to redirect to when a PowerForm is completed?](https://support.docusign.com/en/articles/How-do-I-specify-a-URL-to-redirect-to-when-a-Powerform-is-completed).  ### More information  For more information about creating PowerForms, see [Create a PowerForm](https://support.docusign.com/en/guides/ndse-user-guide-create-a-powerform).  
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_form  (optional parameter)
     # @return [PowerForm]
@@ -74,7 +80,7 @@ module DocuSign_eSign
     end
 
     # Creates a new PowerForm.
-    # 
+    # This method creates a new PowerForm.  You create a PowerForm from an existing DocuSign [template](/docs/esign-rest-api/reference/templates/templates/create/), based on the `templateId` in the request body.   PowerForms that you create from a template are referred to as *web PowerForms*.  **Note:** The DocuSign Admin console also supports creating a PowerForm by uploading a PDF file that has active form fields (referred to as a *PDF PowerForm*). However, PDF PowerForms are deprecated and are not supported in the API.  **Note:** A PowerForm can have only one sender. (Because PowerForms are not necessarily sent by email, this user is also referred to as the PowerForm *initiator*.) If you need to associate multiple senders with a PowerForm, create multiple copies of the PowerForm by using the same template (one copy for each sender). By default, the sender is the PowerForm Administrator who creates the PowerForm.   ### Signing modes  You can use one of the following signing modes for a PowerForm:  **`email`**  This mode verifies the recipient's identity by using email authentication before the recipient can sign a document. The recipient enters their email address on the landing page and then clicks **Begin Signing** to begin the signing process. The system then sends an email message with a validation code to the recipient. If the recipient does not provide a valid email address, they do not receive the email message containing the access code and are not able to open and sign the document.  Alternatively, you can make the process easier for signers by using email authentication only and omitting the access code. To do this, you append the `activateonly` flag to the PowerForm URL and set it to true by passing in the value `1`.  When the flag is active, the first recipient receives an email with a link that initiates the signing session without having to enter access code.  Example: `activateonly=1`  **`direct`**  This mode does not require any verification. After a recipient enters their email address on the landing page and clicks **Begin Signing,** a new browser tab opens and the recipient can immediately begin the signing process.  Because the `direct` signing mode does not verify the recipient's identity by using email authentication, we strongly recommend that you use this mode only when the PowerForm is accessible behind a secure portal where the recipient's identity is already authenticated, or where another form of authentication is specified for the recipient in the DocuSign template (for example, an access code, phone authentication, or ID check).  **Note:** In the account settings, `enablePowerFormDirect` must be **true** to use `direct` as the `signingMode`.  ### Redirect URLs  You can control the URL to which signers are redirected after signing your PowerForm. However, the URL is specified elsewhere, outside of the PowerForm creation process. For details, see [How do I specify a URL to redirect to when a PowerForm is completed?](https://support.docusign.com/en/articles/How-do-I-specify-a-URL-to-redirect-to-when-a-Powerform-is-completed).  ### More information  For more information about creating PowerForms, see [Create a PowerForm](https://support.docusign.com/en/guides/ndse-user-guide-create-a-powerform).  
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_form  (optional parameter)
     # @return [Array<(PowerForm, Fixnum, Hash)>] PowerForm data, response status code and response headers
@@ -115,7 +121,7 @@ module DocuSign_eSign
     end
 
     # Delete a PowerForm.
-    # 
+    # This method deletes a PowerForm.
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_form_id 
     # @return [nil]
@@ -125,7 +131,7 @@ module DocuSign_eSign
     end
 
     # Delete a PowerForm.
-    # 
+    # This method deletes a PowerForm.
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_form_id 
     # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -167,7 +173,7 @@ module DocuSign_eSign
     end
 
     # Deletes one or more PowerForms
-    # 
+    # This method deletes one or more PowerForms. The request body takes an array of PowerForm objects that are deleted based on the `powerFormId`.
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_forms_request  (optional parameter)
     # @return [PowerFormsResponse]
@@ -177,7 +183,7 @@ module DocuSign_eSign
     end
 
     # Deletes one or more PowerForms
-    # 
+    # This method deletes one or more PowerForms. The request body takes an array of PowerForm objects that are deleted based on the &#x60;powerFormId&#x60;.
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_forms_request  (optional parameter)
     # @return [Array<(PowerFormsResponse, Fixnum, Hash)>] PowerFormsResponse data, response status code and response headers
@@ -218,7 +224,7 @@ module DocuSign_eSign
     end
 
     # Returns a single PowerForm.
-    # 
+    # This method returns detailed information about a specific PowerForm.
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_form_id 
     # @return [PowerForm]
@@ -228,7 +234,7 @@ module DocuSign_eSign
     end
 
     # Returns a single PowerForm.
-    # 
+    # This method returns detailed information about a specific PowerForm.
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_form_id 
     # @return [Array<(PowerForm, Fixnum, Hash)>] PowerForm data, response status code and response headers
@@ -271,7 +277,7 @@ module DocuSign_eSign
     end
 
     # Returns the form data associated with the usage of a PowerForm.
-    # 
+    # This method enables Powerform Administrators or the sender of a PowerForm to download the data that recipients have entered into a PowerForm.  You specify the format in which you want to retrieve the data in the `Accept` header. This header accepts the following values:   - `application/json`: JSON format - `application/xml`: XML format - `text/csv`: Comma-separated value (CSV) format  **Note:** Only PowerForm Administrators or the PowerForm Sender can download the data associated with a PowerForm.
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_form_id 
     # @param DocuSign_eSign::GetPowerFormDataOptions Options for modifying the behavior of the function.
@@ -282,7 +288,7 @@ module DocuSign_eSign
     end
 
     # Returns the form data associated with the usage of a PowerForm.
-    # 
+    # This method enables Powerform Administrators or the sender of a PowerForm to download the data that recipients have entered into a PowerForm.  You specify the format in which you want to retrieve the data in the &#x60;Accept&#x60; header. This header accepts the following values:   - &#x60;application/json&#x60;: JSON format - &#x60;application/xml&#x60;: XML format - &#x60;text/csv&#x60;: Comma-separated value (CSV) format  **Note:** Only PowerForm Administrators or the PowerForm Sender can download the data associated with a PowerForm.
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_form_id 
     # @param DocuSign_eSign::GetPowerFormDataOptions Options for modifying the behavior of the function.
@@ -329,7 +335,7 @@ module DocuSign_eSign
     end
 
     # Returns the list of PowerForms available to the user.
-    # 
+    # This method returns a list of users who have sent PowerForms.
     # @param account_id The external account number (int) or account ID Guid.
     # @param DocuSign_eSign::ListPowerFormSendersOptions Options for modifying the behavior of the function.
     # @return [PowerFormSendersResponse]
@@ -339,7 +345,7 @@ module DocuSign_eSign
     end
 
     # Returns the list of PowerForms available to the user.
-    # 
+    # This method returns a list of users who have sent PowerForms.
     # @param account_id The external account number (int) or account ID Guid.
     # @param DocuSign_eSign::ListPowerFormSendersOptions Options for modifying the behavior of the function.
     # @return [Array<(PowerFormSendersResponse, Fixnum, Hash)>] PowerFormSendersResponse data, response status code and response headers
@@ -381,7 +387,7 @@ module DocuSign_eSign
     end
 
     # Returns the list of PowerForms available to the user.
-    # 
+    # This method returns a list of PowerForms that are available to the user.
     # @param account_id The external account number (int) or account ID Guid.
     # @param DocuSign_eSign::ListPowerFormsOptions Options for modifying the behavior of the function.
     # @return [PowerFormsResponse]
@@ -391,7 +397,7 @@ module DocuSign_eSign
     end
 
     # Returns the list of PowerForms available to the user.
-    # 
+    # This method returns a list of PowerForms that are available to the user.
     # @param account_id The external account number (int) or account ID Guid.
     # @param DocuSign_eSign::ListPowerFormsOptions Options for modifying the behavior of the function.
     # @return [Array<(PowerFormsResponse, Fixnum, Hash)>] PowerFormsResponse data, response status code and response headers
@@ -409,6 +415,8 @@ module DocuSign_eSign
       query_params[:'from_date'] = options.from_date if !options.from_date.nil?
       query_params[:'order'] = options.order if !options.order.nil?
       query_params[:'order_by'] = options.order_by if !options.order_by.nil?
+      query_params[:'search_fields'] = options.search_fields if !options.search_fields.nil?
+      query_params[:'search_text'] = options.search_text if !options.search_text.nil?
       query_params[:'to_date'] = options.to_date if !options.to_date.nil?
 
       # header parameters
@@ -436,7 +444,7 @@ module DocuSign_eSign
     end
 
     # Creates a new PowerForm.
-    # 
+    # This method updates an existing PowerForm.
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_form_id 
     # @param power_form  (optional parameter)
@@ -447,7 +455,7 @@ module DocuSign_eSign
     end
 
     # Creates a new PowerForm.
-    # 
+    # This method updates an existing PowerForm.
     # @param account_id The external account number (int) or account ID Guid.
     # @param power_form_id 
     # @param power_form  (optional parameter)

data/lib/docusign_esign/api/templates_api.rb

@@ -361,7 +361,7 @@ module DocuSign_eSign
     end
 
     # Provides a URL to start an edit view of the Template UI
-    # 
+    # This method returns a URL for starting an edit view of a template that uses the DocuSign Template UI.
     # @param account_id The external account number (int) or account ID Guid.
     # @param template_id The ID of the template being accessed.
     # @param return_url_request  (optional parameter)
@@ -372,7 +372,7 @@ module DocuSign_eSign
     end
 
     # Provides a URL to start an edit view of the Template UI
-    # 
+    # This method returns a URL for starting an edit view of a template that uses the DocuSign Template UI.
     # @param account_id The external account number (int) or account ID Guid.
     # @param template_id The ID of the template being accessed.
     # @param return_url_request  (optional parameter)
@@ -639,7 +639,7 @@ module DocuSign_eSign
     end
 
     # Post Responsive HTML Preview for a document in a template.
-    # 
+    # Creates a preview of the [responsive](/docs/esign-rest-api/esign101/concepts/responsive/), HTML version of a specific template document. This method enables you to preview a PDF document conversion to responsive HTML across device types prior to sending.  The request body is a `documentHtmlDefinition` object, which holds the responsive signing parameters that define how to generate the HTML version of the signing document.
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -651,7 +651,7 @@ module DocuSign_eSign
     end
 
     # Post Responsive HTML Preview for a document in a template.
-    # 
+    # Creates a preview of the [responsive](/docs/esign-rest-api/esign101/concepts/responsive/), HTML version of a specific template document. This method enables you to preview a PDF document conversion to responsive HTML across device types prior to sending.  The request body is a `documentHtmlDefinition` object, which holds the responsive signing parameters that define how to generate the HTML version of the signing document.
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -698,7 +698,7 @@ module DocuSign_eSign
     end
 
     # Adds the tabs to a tempate
-    # 
+    # Adds tabs to the document specified by `documentId` in the template specified by `templateId`.  In the request body, you only need to specify the tabs that your are adding. For example, to add a text [prefill tab](/docs/esign-rest-api/reference/templates/templatedocumenttabs/create/#definition__templatetabs_prefilltabs), your request body might look like this:  ``` {   \"prefillTabs\": {     \"textTabs\": [       {         \"value\": \"a prefill text tab\",         \"pageNumber\": \"1\",         \"documentId\": \"1\",         \"xPosition\": 316,         \"yPosition\": 97       }     ]   } } ``` 
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -710,7 +710,7 @@ module DocuSign_eSign
     end
 
     # Adds the tabs to a tempate
-    # 
+    # Adds tabs to the document specified by `documentId` in the template specified by `templateId`.  In the request body, you only need to specify the tabs that your are adding. For example, to add a text [prefill tab](/docs/esign-rest-api/reference/templates/templatedocumenttabs/create/#definition__templatetabs_prefilltabs), your request body might look like this:  ``` {   \"prefillTabs\": {     \"textTabs\": [       {         \"value\": \"a prefill text tab\",         \"pageNumber\": \"1\",         \"documentId\": \"1\",         \"xPosition\": 316,         \"yPosition\": 97       }     ]   } } ``` 
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -757,7 +757,7 @@ module DocuSign_eSign
     end
 
     # Provides a URL to start a recipient view of the Envelope UI
-    # 
+    # This method returns a URL for a template recipient preview  in the DocuSign UI that you can embed in your application. You use this method to enable the sender to preview the recipients' experience.  For more information, see [Preview and Send](https://support.docusign.com/en/guides/ndse-user-guide-send-your-documents).
     # @param account_id The external account number (int) or account ID Guid.
     # @param template_id The ID of the template being accessed.
     # @param recipient_preview_request  (optional parameter)
@@ -768,7 +768,7 @@ module DocuSign_eSign
     end
 
     # Provides a URL to start a recipient view of the Envelope UI
-    # 
+    # This method returns a URL for a template recipient preview  in the DocuSign UI that you can embed in your application. You use this method to enable the sender to preview the recipients' experience.  For more information, see [Preview and Send](https://support.docusign.com/en/guides/ndse-user-guide-send-your-documents).
     # @param account_id The external account number (int) or account ID Guid.
     # @param template_id The ID of the template being accessed.
     # @param recipient_preview_request  (optional parameter)
@@ -812,7 +812,7 @@ module DocuSign_eSign
     end
 
     # Get Responsive HTML Preview for all documents in a template.
-    # 
+    # Creates a preview of the [responsive](/docs/esign-rest-api/esign101/concepts/responsive/), HTML versions of all of the documents associated with a template. This method enables you to preview the PDF document conversions to responsive HTML across device types prior to sending.  The request body is a `documentHtmlDefinition` object, which holds the responsive signing parameters that define how to generate the HTML version of the documents.
     # @param account_id The external account number (int) or account ID Guid.
     # @param template_id The ID of the template being accessed.
     # @param document_html_definition  (optional parameter)
@@ -823,7 +823,7 @@ module DocuSign_eSign
     end
 
     # Get Responsive HTML Preview for all documents in a template.
-    # 
+    # Creates a preview of the [responsive](/docs/esign-rest-api/esign101/concepts/responsive/), HTML versions of all of the documents associated with a template. This method enables you to preview the PDF document conversions to responsive HTML across device types prior to sending.  The request body is a `documentHtmlDefinition` object, which holds the responsive signing parameters that define how to generate the HTML version of the documents.
     # @param account_id The external account number (int) or account ID Guid.
     # @param template_id The ID of the template being accessed.
     # @param document_html_definition  (optional parameter)
@@ -1442,7 +1442,7 @@ module DocuSign_eSign
     end
 
     # Deletes tabs from an envelope document
-    # 
+    # Deletes tabs from the document specified by `documentId` in the template specified by `templateId`. 
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -1454,7 +1454,7 @@ module DocuSign_eSign
     end
 
     # Deletes tabs from an envelope document
-    # 
+    # Deletes tabs from the document specified by `documentId` in the template specified by `templateId`. 
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -1685,7 +1685,7 @@ module DocuSign_eSign
     end
 
     # Returns tabs on the document.
-    # 
+    # Returns the tabs on the document specified by `documentId` in the template specified by `templateId`.  
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -1697,7 +1697,7 @@ module DocuSign_eSign
     end
 
     # Returns tabs on the document.
-    # 
+    # Returns the tabs on the document specified by `documentId` in the template specified by `templateId`.  
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -1851,7 +1851,7 @@ module DocuSign_eSign
     end
 
     # Returns tabs on the specified page.
-    # 
+    # Returns the tabs from the page specified by `pageNumber` of the document specified by `documentId` in the template specified by `templateId`. 
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param page_number The page number being accessed.
@@ -1863,7 +1863,7 @@ module DocuSign_eSign
     end
 
     # Returns tabs on the specified page.
-    # 
+    # Returns the tabs from the page specified by `pageNumber` of the document specified by `documentId` in the template specified by `templateId`. 
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param page_number The page number being accessed.
@@ -1912,7 +1912,7 @@ module DocuSign_eSign
     end
 
     # Returns document page image(s) based on input.
-    # 
+    # Returns images of the pages in a template document for display based on the parameters that you specify.
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -1924,7 +1924,7 @@ module DocuSign_eSign
     end
 
     # Returns document page image(s) based on input.
-    # 
+    # Returns images of the pages in a template document for display based on the parameters that you specify.
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -3142,7 +3142,7 @@ module DocuSign_eSign
     end
 
     # Updates the tabs for a template
-    # 
+    # Updates tabs in the document specified by `documentId` in the template specified by `templateId`. 
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.
@@ -3154,7 +3154,7 @@ module DocuSign_eSign
     end
 
     # Updates the tabs for a template
-    # 
+    # Updates tabs in the document specified by `documentId` in the template specified by `templateId`. 
     # @param account_id The external account number (int) or account ID Guid.
     # @param document_id The ID of the document being accessed.
     # @param template_id The ID of the template being accessed.

data/lib/docusign_esign/api/users_api.rb

@@ -329,7 +329,7 @@ module DocuSign_eSign
     end
 
     # Replaces a particular contact associated with an account for the DocuSign service.
-    # 
+    # This method deletes a contact associated with an account.
     # @param account_id The external account number (int) or account ID Guid.
     # @param contact_id The unique identifier of a person in the contacts address book.
     # @return [ContactUpdateResponse]
@@ -339,7 +339,7 @@ module DocuSign_eSign
     end
 
     # Replaces a particular contact associated with an account for the DocuSign service.
-    # 
+    # This method deletes a contact associated with an account.
     # @param account_id The external account number (int) or account ID Guid.
     # @param contact_id The unique identifier of a person in the contacts address book.
     # @return [Array<(ContactUpdateResponse, Fixnum, Hash)>] ContactUpdateResponse data, response status code and response headers
@@ -382,7 +382,7 @@ module DocuSign_eSign
     end
 
     # Delete contacts associated with an account for the DocuSign service.
-    # 
+    # This method deletes multiple contacts associated with an account.
     # @param account_id The external account number (int) or account ID Guid.
     # @param contact_mod_request  (optional parameter)
     # @return [ContactUpdateResponse]
@@ -392,7 +392,7 @@ module DocuSign_eSign
     end
 
     # Delete contacts associated with an account for the DocuSign service.
-    # 
+    # This method deletes multiple contacts associated with an account.
     # @param account_id The external account number (int) or account ID Guid.
     # @param contact_mod_request  (optional parameter)
     # @return [Array<(ContactUpdateResponse, Fixnum, Hash)>] ContactUpdateResponse data, response status code and response headers
@@ -657,7 +657,7 @@ module DocuSign_eSign
     end
 
     # Gets a particular contact associated with the user's account.
-    # 
+    # This method returns one or more contacts associated with a DocuSign account. You can also retrieve contacts from connected [cloud storage][CloudStorage] providers by using the `cloud_provider` query parameter. By default, contacts are retrieved from the DocuSign account's default address book.  To return a specific contact, use the `contactId` query parameter. To return all contacts associated with an account, omit this parameter.  [CloudStorage]: /docs/esign-rest-api/reference/cloudstorage/
     # @param account_id The external account number (int) or account ID Guid.
     # @param contact_id The unique identifier of a person in the contacts address book.
     # @param DocuSign_eSign::GetContactByIdOptions Options for modifying the behavior of the function.
@@ -668,7 +668,7 @@ module DocuSign_eSign
     end
 
     # Gets a particular contact associated with the user&#39;s account.
-    # 
+    # This method returns one or more contacts associated with a DocuSign account. You can also retrieve contacts from connected [cloud storage][CloudStorage] providers by using the &#x60;cloud_provider&#x60; query parameter. By default, contacts are retrieved from the DocuSign account&#39;s default address book.  To return a specific contact, use the &#x60;contactId&#x60; query parameter. To return all contacts associated with an account, omit this parameter.  [CloudStorage]: /docs/esign-rest-api/reference/cloudstorage/
     # @param account_id The external account number (int) or account ID Guid.
     # @param contact_id The unique identifier of a person in the contacts address book.
     # @param DocuSign_eSign::GetContactByIdOptions Options for modifying the behavior of the function.
@@ -1226,7 +1226,7 @@ module DocuSign_eSign
     end
 
     # Imports multiple new contacts into the contacts collection from CSV, JSON, or XML (based on content type).
-    # 
+    # This method adds multiple contacts into a contacts list.
     # @param account_id The external account number (int) or account ID Guid.
     # @param contact_mod_request  (optional parameter)
     # @return [ContactUpdateResponse]
@@ -1236,7 +1236,7 @@ module DocuSign_eSign
     end
 
     # Imports multiple new contacts into the contacts collection from CSV, JSON, or XML (based on content type).
-    # 
+    # This method adds multiple contacts into a contacts list.
     # @param account_id The external account number (int) or account ID Guid.
     # @param contact_mod_request  (optional parameter)
     # @return [Array<(ContactUpdateResponse, Fixnum, Hash)>] ContactUpdateResponse data, response status code and response headers
@@ -1277,7 +1277,7 @@ module DocuSign_eSign
     end
 
     # Replaces contacts associated with an account for the DocuSign service.
-    # 
+    # This method updates one or more contacts associated with an account.
     # @param account_id The external account number (int) or account ID Guid.
     # @param contact_mod_request  (optional parameter)
     # @return [ContactUpdateResponse]
@@ -1287,7 +1287,7 @@ module DocuSign_eSign
     end
 
     # Replaces contacts associated with an account for the DocuSign service.
-    # 
+    # This method updates one or more contacts associated with an account.
     # @param account_id The external account number (int) or account ID Guid.
     # @param contact_mod_request  (optional parameter)
     # @return [Array<(ContactUpdateResponse, Fixnum, Hash)>] ContactUpdateResponse data, response status code and response headers
@@ -1731,7 +1731,7 @@ module DocuSign_eSign
     end
 
     # Updates the specified user information.
-    # 
+    # To update user information for a specific user, submit a [Users](#Users) object with updated field values in the request body of this operation.
     # @param account_id The external account number (int) or account ID Guid.
     # @param user_id The user ID of the user being accessed. Generally this is the user ID of the authenticated user, but if the authenticated user is an Admin on the account, this may be another user the Admin user is accessing.
     # @param user_information  (optional parameter)
@@ -1743,7 +1743,7 @@ module DocuSign_eSign
     end
 
     # Updates the specified user information.
-    # 
+    # To update user information for a specific user, submit a [Users](#Users) object with updated field values in the request body of this operation.
     # @param account_id The external account number (int) or account ID Guid.
     # @param user_id The user ID of the user being accessed. Generally this is the user ID of the authenticated user, but if the authenticated user is an Admin on the account, this may be another user the Admin user is accessing.
     # @param user_information  (optional parameter)
@@ -1789,7 +1789,7 @@ module DocuSign_eSign
     end
 
     # Change one or more user in the specified account.
-    # 
+    # This method updates the information about one or more account users.
     # @param account_id The external account number (int) or account ID Guid.
     # @param user_information_list  (optional parameter)
     # @param DocuSign_eSign::UpdateUsersOptions Options for modifying the behavior of the function.
@@ -1800,7 +1800,7 @@ module DocuSign_eSign
     end
 
     # Change one or more user in the specified account.
-    # 
+    # This method updates the information about one or more account users.
     # @param account_id The external account number (int) or account ID Guid.
     # @param user_information_list  (optional parameter)
     # @param DocuSign_eSign::UpdateUsersOptions Options for modifying the behavior of the function.

data/lib/docusign_esign/api/workspaces_api.rb

@@ -133,7 +133,7 @@ module DocuSign_eSign
     end
 
     # Creates a workspace file.
-    # 
+    # This method adds a file to a workspace.
     # @param account_id The external account number (int) or account ID Guid.
     # @param folder_id The ID of the folder being accessed.
     # @param workspace_id Specifies the workspace ID GUID.
@@ -144,7 +144,7 @@ module DocuSign_eSign
     end
 
     # Creates a workspace file.
-    # 
+    # This method adds a file to a workspace.
     # @param account_id The external account number (int) or account ID Guid.
     # @param folder_id The ID of the folder being accessed.
     # @param workspace_id Specifies the workspace ID GUID.
@@ -243,7 +243,7 @@ module DocuSign_eSign
     end
 
     # Deletes workspace one or more specific files/folders from the given folder or root.
-    # 
+    # This method deletes one or more files or sub-folders from a workspace folder or root.  Note: To delete items from a workspace, the `status` of the workspace must be `active`.
     # @param account_id The external account number (int) or account ID Guid.
     # @param folder_id The ID of the folder being accessed.
     # @param workspace_id Specifies the workspace ID GUID.
@@ -255,7 +255,7 @@ module DocuSign_eSign
     end
 
     # Deletes workspace one or more specific files/folders from the given folder or root.
-    # 
+    # This method deletes one or more files or sub-folders from a workspace folder or root.  Note: To delete items from a workspace, the `status` of the workspace must be `active`.
     # @param account_id The external account number (int) or account ID Guid.
     # @param folder_id The ID of the folder being accessed.
     # @param workspace_id Specifies the workspace ID GUID.