Add more detailed description of template create

Author: erkkinen

openapi-sdk.yaml

@@ -6260,7 +6260,12 @@ paths:
       tags:
         - Template
       summary: 'Create Template'
-      description: 'Creates a template that can then be used.'
+      description: |-
+        Creates a template that can be used in future signature requests.
+
+        If `client_id` is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new `edit_url` with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).
+
+        Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A `template_created` event indicates the template is ready to use, while a `template_error` event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
       operationId: templateCreate
       requestBody:
         required: true

openapi.yaml

@@ -6260,7 +6260,12 @@ paths:
       tags:
         - Template
       summary: 'Create Template'
-      description: 'Creates a template that can then be used.'
+      description: |-
+        Creates a template that can be used in future signature requests.
+
+        If `client_id` is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new `edit_url` with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).
+
+        Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A `template_created` event indicates the template is ready to use, while a `template_error` event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
       operationId: templateCreate
       requestBody:
         required: true

sdks/dotnet/docs/TemplateApi.md

@@ -125,7 +125,7 @@ catch (ApiException e)
 
 Create Template
 
-Creates a template that can then be used.
+Creates a template that can be used in future signature requests.  If `client_id` is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new `edit_url` with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).  Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A `template_created` event indicates the template is ready to use, while a `template_error` event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
 
 ### Example
 ```csharp

sdks/dotnet/src/Dropbox.Sign/Api/TemplateApi.cs

@@ -56,7 +56,7 @@ public interface ITemplateApiSync : IApiAccessor
         /// Create Template
         /// </summary>
         /// <remarks>
-        /// Creates a template that can then be used.
+        /// Creates a template that can be used in future signature requests.  If &#x60;client_id&#x60; is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new &#x60;edit_url&#x60; with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).  Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A &#x60;template_created&#x60; event indicates the template is ready to use, while a &#x60;template_error&#x60; event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
         /// </remarks>
         /// <exception cref="Dropbox.Sign.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="templateCreateRequest"></param>
@@ -68,7 +68,7 @@ public interface ITemplateApiSync : IApiAccessor
         /// Create Template
         /// </summary>
         /// <remarks>
-        /// Creates a template that can then be used.
+        /// Creates a template that can be used in future signature requests.  If &#x60;client_id&#x60; is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new &#x60;edit_url&#x60; with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).  Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A &#x60;template_created&#x60; event indicates the template is ready to use, while a &#x60;template_error&#x60; event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
         /// </remarks>
         /// <exception cref="Dropbox.Sign.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="templateCreateRequest"></param>
@@ -361,7 +361,7 @@ public interface ITemplateApiAsync : IApiAccessor
         /// Create Template
         /// </summary>
         /// <remarks>
-        /// Creates a template that can then be used.
+        /// Creates a template that can be used in future signature requests.  If &#x60;client_id&#x60; is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new &#x60;edit_url&#x60; with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).  Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A &#x60;template_created&#x60; event indicates the template is ready to use, while a &#x60;template_error&#x60; event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
         /// </remarks>
         /// <exception cref="Dropbox.Sign.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="templateCreateRequest"></param>
@@ -374,7 +374,7 @@ public interface ITemplateApiAsync : IApiAccessor
         /// Create Template
         /// </summary>
         /// <remarks>
-        /// Creates a template that can then be used.
+        /// Creates a template that can be used in future signature requests.  If &#x60;client_id&#x60; is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new &#x60;edit_url&#x60; with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).  Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A &#x60;template_created&#x60; event indicates the template is ready to use, while a &#x60;template_error&#x60; event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
         /// </remarks>
         /// <exception cref="Dropbox.Sign.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="templateCreateRequest"></param>
@@ -971,7 +971,7 @@ public Dropbox.Sign.Client.ApiResponse<TemplateGetResponse> TemplateAddUserWithH
         }
 
         /// <summary>
-        /// Create Template Creates a template that can then be used.
+        /// Create Template Creates a template that can be used in future signature requests.  If &#x60;client_id&#x60; is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new &#x60;edit_url&#x60; with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).  Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A &#x60;template_created&#x60; event indicates the template is ready to use, while a &#x60;template_error&#x60; event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
         /// </summary>
         /// <exception cref="Dropbox.Sign.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="templateCreateRequest"></param>
@@ -984,7 +984,7 @@ public TemplateCreateResponse TemplateCreate(TemplateCreateRequest templateCreat
         }
 
         /// <summary>
-        /// Create Template Creates a template that can then be used.
+        /// Create Template Creates a template that can be used in future signature requests.  If &#x60;client_id&#x60; is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new &#x60;edit_url&#x60; with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).  Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A &#x60;template_created&#x60; event indicates the template is ready to use, while a &#x60;template_error&#x60; event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
         /// </summary>
         /// <exception cref="Dropbox.Sign.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="templateCreateRequest"></param>
@@ -1061,7 +1061,7 @@ public Dropbox.Sign.Client.ApiResponse<TemplateCreateResponse> TemplateCreateWit
         }
 
         /// <summary>
-        /// Create Template Creates a template that can then be used.
+        /// Create Template Creates a template that can be used in future signature requests.  If &#x60;client_id&#x60; is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new &#x60;edit_url&#x60; with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).  Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A &#x60;template_created&#x60; event indicates the template is ready to use, while a &#x60;template_error&#x60; event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
         /// </summary>
         /// <exception cref="Dropbox.Sign.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="templateCreateRequest"></param>
@@ -1075,7 +1075,7 @@ public Dropbox.Sign.Client.ApiResponse<TemplateCreateResponse> TemplateCreateWit
         }
 
         /// <summary>
-        /// Create Template Creates a template that can then be used.
+        /// Create Template Creates a template that can be used in future signature requests.  If &#x60;client_id&#x60; is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new &#x60;edit_url&#x60; with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).  Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A &#x60;template_created&#x60; event indicates the template is ready to use, while a &#x60;template_error&#x60; event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
         /// </summary>
         /// <exception cref="Dropbox.Sign.Client.ApiException">Thrown when fails to make API call</exception>
         /// <param name="templateCreateRequest"></param>

sdks/java-v1/docs/TemplateApi.md

@@ -112,7 +112,11 @@ public class TemplateAddUserExample
 
 Create Template
 
-Creates a template that can then be used.
+Creates a template that can be used in future signature requests.
+
+If `client_id` is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new `edit_url` with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).
+
+Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A `template_created` event indicates the template is ready to use, while a `template_error` event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
 
 ### Example
 

sdks/java-v1/src/main/java/com/dropbox/sign/api/TemplateApi.java

@@ -145,7 +145,18 @@ public ApiResponse<TemplateGetResponse> templateAddUserWithHttpInfo(
     }
 
     /**
-     * Create Template Creates a template that can then be used.
+     * Create Template Creates a template that can be used in future signature requests. If
+     * &#x60;client_id&#x60; is provided, the template will be created as an embedded template.
+     * Embedded templates can be used for embedded signature requests and can be edited later by
+     * generating a new &#x60;edit_url&#x60; with
+     * [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/). Template
+     * creation may complete asynchronously after the initial request is accepted. It is recommended
+     * that a callback be implemented to listen for the callback event. A
+     * &#x60;template_created&#x60; event indicates the template is ready to use, while a
+     * &#x60;template_error&#x60; event indicates there was a problem while creating the template.
+     * If a callback handler has been configured and the event has not been received within 60
+     * minutes of making the call, check the status of the request in the API dashboard and retry
+     * the request if necessary.
      *
      * @param templateCreateRequest (required)
      * @return TemplateCreateResponse
@@ -164,7 +175,18 @@ public TemplateCreateResponse templateCreate(TemplateCreateRequest templateCreat
     }
 
     /**
-     * Create Template Creates a template that can then be used.
+     * Create Template Creates a template that can be used in future signature requests. If
+     * &#x60;client_id&#x60; is provided, the template will be created as an embedded template.
+     * Embedded templates can be used for embedded signature requests and can be edited later by
+     * generating a new &#x60;edit_url&#x60; with
+     * [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/). Template
+     * creation may complete asynchronously after the initial request is accepted. It is recommended
+     * that a callback be implemented to listen for the callback event. A
+     * &#x60;template_created&#x60; event indicates the template is ready to use, while a
+     * &#x60;template_error&#x60; event indicates there was a problem while creating the template.
+     * If a callback handler has been configured and the event has not been received within 60
+     * minutes of making the call, check the status of the request in the API dashboard and retry
+     * the request if necessary.
      *
      * @param templateCreateRequest (required)
      * @return ApiResponse&lt;TemplateCreateResponse&gt;

sdks/java-v2/docs/TemplateApi.md

@@ -112,7 +112,11 @@ public class TemplateAddUserExample
 
 Create Template
 
-Creates a template that can then be used.
+Creates a template that can be used in future signature requests.
+
+If `client_id` is provided, the template will be created as an embedded template. Embedded templates can be used for embedded signature requests and can be edited later by generating a new `edit_url` with [/embedded/edit_url/{template_id}](/api/reference/operation/embeddedEditUrl/).
+
+Template creation may complete asynchronously after the initial request is accepted. It is recommended that a callback be implemented to listen for the callback event. A `template_created` event indicates the template is ready to use, while a `template_error` event indicates there was a problem while creating the template. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.
 
 ### Example