dropbox-sign 1.1.2 → 1.2.0

data/openapi-sdk.yaml

@@ -3364,6 +3364,8 @@ paths:
       description: |-
         Updates the email address and/or the name for a given signer on a signature request. You can listen for the `signature_request_email_bounce` event on your app or account to detect bounced emails, and respond with this method.
 
+        Updating the email address of a signer will generate a new `signature_id` value.
+
         **NOTE**: This action cannot be performed on a signature request with an appended signature page.
       operationId: signatureRequestUpdate
       parameters:
@@ -4630,6 +4632,120 @@ paths:
         seo:
           title: 'Add User to Template | REST API | Dropbox Sign for Developers'
           description: 'The RESTful Dropbox Sign API easily allows you to build custom eSign integrations. To find out how to give an Account access to a Template, click here.'
+  /template/create:
+    post:
+      tags:
+        - Template
+      summary: 'Create  Template'
+      description: 'Creates a template that can then be used.'
+      operationId: templateCreate
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TemplateCreateRequest'
+            examples:
+              default_example:
+                $ref: '#/components/examples/TemplateCreateRequestDefaultExample'
+              form_fields_per_document:
+                $ref: '#/components/examples/TemplateCreateRequestFormFieldsPerDocumentExample'
+              form_field_groups:
+                $ref: '#/components/examples/TemplateCreateRequestFormFieldGroupsExample'
+              form_field_rules:
+                $ref: '#/components/examples/TemplateCreateRequestFormFieldRulesExample'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/TemplateCreateRequest'
+      responses:
+        200:
+          description: 'successful operation'
+          headers:
+            X-RateLimit-Limit:
+              $ref: '#/components/headers/X-RateLimit-Limit'
+            X-RateLimit-Remaining:
+              $ref: '#/components/headers/X-RateLimit-Remaining'
+            X-Ratelimit-Reset:
+              $ref: '#/components/headers/X-Ratelimit-Reset'
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TemplateCreateResponse'
+              examples:
+                default_example:
+                  $ref: '#/components/examples/TemplateCreateResponseExample'
+        4XX:
+          description: failed_operation
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+              examples:
+                400_example:
+                  $ref: '#/components/examples/Error400ResponseExample'
+                401_example:
+                  $ref: '#/components/examples/Error401ResponseExample'
+                402_example:
+                  $ref: '#/components/examples/Error402ResponseExample'
+                403_example:
+                  $ref: '#/components/examples/Error403ResponseExample'
+                404_example:
+                  $ref: '#/components/examples/Error404ResponseExample'
+                409_example:
+                  $ref: '#/components/examples/Error409ResponseExample'
+                4XX_example:
+                  $ref: '#/components/examples/Error4XXResponseExample'
+      security:
+        -
+          api_key: []
+        -
+          oauth2:
+            - template_access
+      x-codeSamples:
+        -
+          lang: PHP
+          label: PHP
+          source:
+            $ref: examples/TemplateCreate.php
+        -
+          lang: 'C#'
+          label: 'C#'
+          source:
+            $ref: examples/TemplateCreate.cs
+        -
+          lang: JavaScript
+          label: JavaScript
+          source:
+            $ref: examples/TemplateCreate.js
+        -
+          lang: TypeScript
+          label: TypeScript
+          source:
+            $ref: examples/TemplateCreate.ts
+        -
+          lang: Java
+          label: Java
+          source:
+            $ref: examples/TemplateCreate.java
+        -
+          lang: Ruby
+          label: Ruby
+          source:
+            $ref: examples/TemplateCreate.rb
+        -
+          lang: Python
+          label: Python
+          source:
+            $ref: examples/TemplateCreate.py
+        -
+          lang: cURL
+          label: cURL
+          source:
+            $ref: examples/TemplateCreate.sh
+      x-meta:
+        seo:
+          title: 'Create Template | Dropbox Sign for Developers'
+          description: 'The RESTful Dropbox Sign API easily allows you to build custom eSign integrations. To find out how to create an template, click here.'
   /template/create_embedded_draft:
     post:
       tags:
@@ -6279,226 +6395,6 @@ components:
           type: boolean
           default: false
       type: object
-    SubFormFieldsPerDocumentTypeEnum:
-      type: string
-      enum:
-        - checkbox
-        - checkbox-merge
-        - date_signed
-        - dropdown
-        - hyperlink
-        - initials
-        - signature
-        - radio
-        - text
-        - text-merge
-    SubFormFieldsPerDocumentText:
-      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
-      allOf:
-        -
-          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
-        -
-          required:
-            - type
-            - options
-          properties:
-            type:
-              description: 'A text input field. Use the `SubFormFieldsPerDocumentText` class.'
-              type: string
-              default: text
-            placeholder:
-              description: 'Placeholder value for text field.'
-              type: string
-            auto_fill_type:
-              description: 'Auto fill type for populating fields automatically. Check out the list of [auto fill types](/api/reference/constants/#auto-fill-types) to learn more about the possible values.'
-              type: string
-            link_id:
-              description: 'Link two or more text fields. Enter data into one linked text field, which automatically fill all other linked text fields.'
-              type: string
-            masked:
-              description: 'Masks entered data. For more information see [Masking sensitive information](https://faq.hellosign.com/hc/en-us/articles/360040742811-Masking-sensitive-information). `true` for masking the data in a text field, otherwise `false`.'
-              type: boolean
-            validation_type:
-              description: |-
-                Each text field may contain a `validation_type` parameter. Check out the list of [validation types](https://faq.hellosign.com/hc/en-us/articles/217115577) to learn more about the possible values.
-
-                **NOTE**: When using `custom_regex` you are required to pass a second parameter `validation_custom_regex` and you can optionally provide `validation_custom_regex_format_label` for the error message the user will see in case of an invalid value.
-              type: string
-              enum:
-                - numbers_only
-                - letters_only
-                - phone_number
-                - bank_routing_number
-                - bank_account_number
-                - email_address
-                - zip_code
-                - social_security_number
-                - employer_identification_number
-                - custom_regex
-            validation_custom_regex:
-              type: string
-            validation_custom_regex_format_label:
-              type: string
-          type: object
-    SubFormFieldsPerDocumentDropdown:
-      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
-      allOf:
-        -
-          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
-        -
-          required:
-            - type
-            - options
-          properties:
-            type:
-              description: 'An input field for dropdowns. Use the `SubFormFieldsPerDocumentDropdown` class.'
-              type: string
-              default: dropdown
-            options:
-              description: 'Array of string values representing dropdown values.'
-              type: array
-              items:
-                type: string
-              minItems: 1
-            content:
-              description: 'Selected value in `options` array. Value must exist in array.'
-              type: string
-          type: object
-    SubFormFieldsPerDocumentHyperlink:
-      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
-      allOf:
-        -
-          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
-        -
-          required:
-            - type
-            - content
-            - content_url
-          properties:
-            type:
-              description: 'A hyperlink field. Use the `SubFormFieldsPerDocumentHyperlink` class.'
-              type: string
-              default: hyperlink
-            content:
-              description: 'Link Text.'
-              type: string
-            content_url:
-              description: 'Link URL.'
-              type: string
-          type: object
-    SubFormFieldsPerDocumentCheckbox:
-      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
-      allOf:
-        -
-          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
-        -
-          required:
-            - type
-            - is_checked
-          properties:
-            type:
-              description: 'A yes/no checkbox. Use the `SubFormFieldsPerDocumentCheckbox` class.'
-              type: string
-              default: checkbox
-            group:
-              description: 'String referencing group defined in `form_field_groups` parameter.'
-              type: string
-            is_checked:
-              description: '`true` for checking the checkbox field by default, otherwise `false`.'
-              type: boolean
-          type: object
-    SubFormFieldsPerDocumentRadio:
-      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
-      allOf:
-        -
-          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
-        -
-          required:
-            - type
-            - group
-            - is_checked
-          properties:
-            type:
-              description: 'An input field for radios. Use the `SubFormFieldsPerDocumentRadio` class.'
-              type: string
-              default: radio
-            group:
-              description: 'String referencing group defined in `form_field_groups` parameter.'
-              type: string
-            is_checked:
-              description: '`true` for checking the radio field by default, otherwise `false`. Only one radio field per group can be `true`.'
-              type: boolean
-          type: object
-    SubFormFieldsPerDocumentSignature:
-      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
-      allOf:
-        -
-          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
-        -
-          required:
-            - type
-          properties:
-            type:
-              description: 'A signature input field. Use the `SubFormFieldsPerDocumentSignature` class.'
-              type: string
-              default: signature
-          type: object
-    SubFormFieldsPerDocumentDateSigned:
-      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
-      allOf:
-        -
-          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
-        -
-          required:
-            - type
-          properties:
-            type:
-              description: 'A date. Use the `SubFormFieldsPerDocumentDateSigned` class.'
-              type: string
-              default: date_signed
-          type: object
-    SubFormFieldsPerDocumentInitials:
-      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
-      allOf:
-        -
-          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
-        -
-          required:
-            - type
-          properties:
-            type:
-              description: 'An input field for initials. Use the `SubFormFieldsPerDocumentInitials` class.'
-              type: string
-              default: initials
-          type: object
-    SubFormFieldsPerDocumentTextMerge:
-      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
-      allOf:
-        -
-          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
-        -
-          required:
-            - type
-          properties:
-            type:
-              description: 'A text field that has default text set using pre-filled data. Use the `SubFormFieldsPerDocumentTextMerge` class.'
-              type: string
-              default: text-merge
-          type: object
-    SubFormFieldsPerDocumentCheckboxMerge:
-      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
-      allOf:
-        -
-          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
-        -
-          required:
-            - type
-          properties:
-            type:
-              description: 'A checkbox field that has default value set using pre-filled data. Use the `SubFormFieldsPerDocumentCheckboxMerge` class.'
-              type: string
-              default: checkbox-merge
-          type: object
     OAuthTokenGenerateRequest:
       required:
         - client_id
@@ -6886,7 +6782,6 @@ components:
           description: 'When the signature request will expire. Unsigned signatures will be moved to the expired status, and no longer signable. See [Signature Request Expiration Date](https://developers.hellosign.com/docs/signature-request/expiration/) for details.'
           type: integer
           nullable: true
-          x-beta: closed
       type: object
     SignatureRequestCreateEmbeddedWithTemplateRequest:
       required:
@@ -7101,6 +6996,16 @@ components:
             Cannot be used in `test_mode`. Only works on requests with one signer.
           type: boolean
           default: false
+          deprecated: true
+          x-hideOn: doc
+        is_eid:
+          description: |-
+            Send with a value of `true` if you wish to enable
+            [electronic identification (eID)](https://www.hellosign.com/features/electronic-id),
+            which requires the signer to verify their identity with an eID provider to sign a document.<br>
+            **Note**: eID is only available on the Premium API plan. Cannot be used in `test_mode`. Only works on requests with one signer.
+          type: boolean
+          default: false
         message:
           description: 'The custom message in the email that will be sent to the signers.'
           type: string
@@ -7138,7 +7043,6 @@ components:
           description: 'When the signature request will expire. Unsigned signatures will be moved to the expired status, and no longer signable. See [Signature Request Expiration Date](https://developers.hellosign.com/docs/signature-request/expiration/) for details.'
           type: integer
           nullable: true
-          x-beta: closed
       type: object
     SignatureRequestSendWithTemplateRequest:
       description: ''
@@ -7194,6 +7098,16 @@ components:
             Cannot be used in `test_mode`. Only works on requests with one signer.
           type: boolean
           default: false
+          deprecated: true
+          x-hideOn: doc
+        is_eid:
+          description: |-
+            Send with a value of `true` if you wish to enable
+            [electronic identification (eID)](https://www.hellosign.com/features/electronic-id),
+            which requires the signer to verify their identity with an eID provider to sign a document.<br>
+            **Note**: eID is only available on the Premium API plan. Cannot be used in `test_mode`. Only works on requests with one signer.
+          type: boolean
+          default: false
         message:
           description: 'The custom message in the email that will be sent to the signers.'
           type: string
@@ -7237,6 +7151,8 @@ components:
           description: |-
             The new email address for the recipient.
 
+            This will generate a new `signature_id` value.
+
             **NOTE**: Optional if `name` is provided.
           type: string
           format: email
@@ -7253,7 +7169,6 @@ components:
           description: 'The new time when the signature request will expire. Unsigned signatures will be moved to the expired status, and no longer signable. See [Signature Request Expiration Date](https://developers.hellosign.com/docs/signature-request/expiration/) for details.'
           type: integer
           nullable: true
-          x-beta: closed
       type: object
     SubAttachment:
       required:
@@ -7508,22 +7423,414 @@ components:
               - `not`
               - `match`
 
-            Otherwise,
-            - **checkbox**: When **type** of trigger is **checkbox**, **value** must be `0` or `1`
-            - **radio**: When **type** of trigger is **radio**, **value** must be `1`
-          type: string
-        values:
-          description: |-
-            **values** or **value** is required, but not both.
+            Otherwise,
+            - **checkbox**: When **type** of trigger is **checkbox**, **value** must be `0` or `1`
+            - **radio**: When **type** of trigger is **radio**, **value** must be `1`
+          type: string
+        values:
+          description: |-
+            **values** or **value** is required, but not both.
+
+            The values to match against **operator** when it is one of the following:
+
+            - `any`
+            - `none`
+          type: array
+          items:
+            type: string
+      type: object
+    SubFormFieldsPerDocumentCheckbox:
+      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
+      allOf:
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        -
+          required:
+            - type
+            - is_checked
+          properties:
+            type:
+              description: 'A yes/no checkbox. Use the `SubFormFieldsPerDocumentCheckbox` class.'
+              type: string
+              default: checkbox
+            group:
+              description: 'String referencing group defined in `form_field_groups` parameter.'
+              type: string
+            is_checked:
+              description: '`true` for checking the checkbox field by default, otherwise `false`.'
+              type: boolean
+          type: object
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+    SubFormFieldsPerDocumentCheckboxMerge:
+      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
+      allOf:
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        -
+          required:
+            - type
+          properties:
+            type:
+              description: 'A checkbox field that has default value set using pre-filled data. Use the `SubFormFieldsPerDocumentCheckboxMerge` class.'
+              type: string
+              default: checkbox-merge
+          type: object
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+    SubFormFieldsPerDocumentDateSigned:
+      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
+      allOf:
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        -
+          required:
+            - type
+          properties:
+            type:
+              description: 'A date. Use the `SubFormFieldsPerDocumentDateSigned` class.'
+              type: string
+              default: date_signed
+            font_family:
+              description: 'Font family for the field.'
+              type: string
+              enum:
+                - helvetica
+                - arial
+                - courier
+                - calibri
+                - cambria
+                - georgia
+                - times
+                - trebuchet
+                - verdana
+                - roboto
+                - robotoMono
+                - notoSans
+                - notoSerif
+                - notoCJK-JP-Regular
+                - notoHebrew-Regular
+                - notoSanThaiMerged
+            font_size:
+              description: |-
+                The initial px font size for the field contents. Can be any integer value between `7` and `49`.
+
+                **NOTE**: Font size may be reduced during processing in order to fit the contents within the dimensions of the field.
+              type: integer
+          type: object
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+    SubFormFieldsPerDocumentDropdown:
+      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
+      allOf:
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        -
+          required:
+            - type
+            - options
+          properties:
+            type:
+              description: 'An input field for dropdowns. Use the `SubFormFieldsPerDocumentDropdown` class.'
+              type: string
+              default: dropdown
+            options:
+              description: 'Array of string values representing dropdown values.'
+              type: array
+              items:
+                type: string
+              minItems: 1
+            content:
+              description: 'Selected value in `options` array. Value must exist in array.'
+              type: string
+            font_family:
+              description: 'Font family for the field.'
+              type: string
+              enum:
+                - helvetica
+                - arial
+                - courier
+                - calibri
+                - cambria
+                - georgia
+                - times
+                - trebuchet
+                - verdana
+                - roboto
+                - robotoMono
+                - notoSans
+                - notoSerif
+                - notoCJK-JP-Regular
+                - notoHebrew-Regular
+                - notoSanThaiMerged
+            font_size:
+              description: |-
+                The initial px font size for the field contents. Can be any integer value between `7` and `49`.
+
+                **NOTE**: Font size may be reduced during processing in order to fit the contents within the dimensions of the field.
+              type: integer
+          type: object
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+    SubFormFieldsPerDocumentHyperlink:
+      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
+      allOf:
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        -
+          required:
+            - type
+            - content
+            - content_url
+          properties:
+            type:
+              description: 'A hyperlink field. Use the `SubFormFieldsPerDocumentHyperlink` class.'
+              type: string
+              default: hyperlink
+            content:
+              description: 'Link Text.'
+              type: string
+            content_url:
+              description: 'Link URL.'
+              type: string
+            font_family:
+              description: 'Font family for the field.'
+              type: string
+              enum:
+                - helvetica
+                - arial
+                - courier
+                - calibri
+                - cambria
+                - georgia
+                - times
+                - trebuchet
+                - verdana
+                - roboto
+                - robotoMono
+                - notoSans
+                - notoSerif
+                - notoCJK-JP-Regular
+                - notoHebrew-Regular
+                - notoSanThaiMerged
+            font_size:
+              description: |-
+                The initial px font size for the field contents. Can be any integer value between `7` and `49`.
+
+                **NOTE**: Font size may be reduced during processing in order to fit the contents within the dimensions of the field.
+              type: integer
+          type: object
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+    SubFormFieldsPerDocumentInitials:
+      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
+      allOf:
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        -
+          required:
+            - type
+          properties:
+            type:
+              description: 'An input field for initials. Use the `SubFormFieldsPerDocumentInitials` class.'
+              type: string
+              default: initials
+          type: object
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+    SubFormFieldsPerDocumentRadio:
+      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
+      allOf:
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        -
+          required:
+            - type
+            - group
+            - is_checked
+          properties:
+            type:
+              description: 'An input field for radios. Use the `SubFormFieldsPerDocumentRadio` class.'
+              type: string
+              default: radio
+            group:
+              description: 'String referencing group defined in `form_field_groups` parameter.'
+              type: string
+            is_checked:
+              description: '`true` for checking the radio field by default, otherwise `false`. Only one radio field per group can be `true`.'
+              type: boolean
+          type: object
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+    SubFormFieldsPerDocumentSignature:
+      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
+      allOf:
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        -
+          required:
+            - type
+          properties:
+            type:
+              description: 'A signature input field. Use the `SubFormFieldsPerDocumentSignature` class.'
+              type: string
+              default: signature
+          type: object
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+    SubFormFieldsPerDocumentText:
+      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
+      allOf:
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        -
+          required:
+            - type
+            - options
+          properties:
+            type:
+              description: 'A text input field. Use the `SubFormFieldsPerDocumentText` class.'
+              type: string
+              default: text
+            placeholder:
+              description: 'Placeholder value for text field.'
+              type: string
+            auto_fill_type:
+              description: 'Auto fill type for populating fields automatically. Check out the list of [auto fill types](/api/reference/constants/#auto-fill-types) to learn more about the possible values.'
+              type: string
+            link_id:
+              description: 'Link two or more text fields. Enter data into one linked text field, which automatically fill all other linked text fields.'
+              type: string
+            masked:
+              description: 'Masks entered data. For more information see [Masking sensitive information](https://faq.hellosign.com/hc/en-us/articles/360040742811-Masking-sensitive-information). `true` for masking the data in a text field, otherwise `false`.'
+              type: boolean
+            validation_type:
+              description: |-
+                Each text field may contain a `validation_type` parameter. Check out the list of [validation types](https://faq.hellosign.com/hc/en-us/articles/217115577) to learn more about the possible values.
+
+                **NOTE**: When using `custom_regex` you are required to pass a second parameter `validation_custom_regex` and you can optionally provide `validation_custom_regex_format_label` for the error message the user will see in case of an invalid value.
+              type: string
+              enum:
+                - numbers_only
+                - letters_only
+                - phone_number
+                - bank_routing_number
+                - bank_account_number
+                - email_address
+                - zip_code
+                - social_security_number
+                - employer_identification_number
+                - custom_regex
+            validation_custom_regex:
+              type: string
+            validation_custom_regex_format_label:
+              type: string
+            content:
+              description: 'Content of a `me_now` text field'
+              type: string
+            font_family:
+              description: 'Font family for the field.'
+              type: string
+              enum:
+                - helvetica
+                - arial
+                - courier
+                - calibri
+                - cambria
+                - georgia
+                - times
+                - trebuchet
+                - verdana
+                - roboto
+                - robotoMono
+                - notoSans
+                - notoSerif
+                - notoCJK-JP-Regular
+                - notoHebrew-Regular
+                - notoSanThaiMerged
+            font_size:
+              description: |-
+                The initial px font size for the field contents. Can be any integer value between `7` and `49`.
 
-            The values to match against **operator** when it is one of the following:
+                **NOTE**: Font size may be reduced during processing in order to fit the contents within the dimensions of the field.
+              type: integer
+          type: object
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+    SubFormFieldsPerDocumentTextMerge:
+      description: 'This class extends `SubFormFieldsPerDocumentBase`.'
+      allOf:
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        -
+          required:
+            - type
+          properties:
+            type:
+              description: 'A text field that has default text set using pre-filled data. Use the `SubFormFieldsPerDocumentTextMerge` class.'
+              type: string
+              default: text-merge
+            font_family:
+              description: 'Font family for the field.'
+              type: string
+              enum:
+                - helvetica
+                - arial
+                - courier
+                - calibri
+                - cambria
+                - georgia
+                - times
+                - trebuchet
+                - verdana
+                - roboto
+                - robotoMono
+                - notoSans
+                - notoSerif
+                - notoCJK-JP-Regular
+                - notoHebrew-Regular
+                - notoSanThaiMerged
+            font_size:
+              description: |-
+                The initial px font size for the field contents. Can be any integer value between `7` and `49`.
 
-            - `any`
-            - `none`
-          type: array
-          items:
-            type: string
-      type: object
+                **NOTE**: Font size may be reduced during processing in order to fit the contents within the dimensions of the field.
+              type: integer
+          type: object
+        -
+          $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+    SubFormFieldsPerDocumentTypeEnum:
+      type: string
+      enum:
+        - checkbox
+        - checkbox-merge
+        - date_signed
+        - dropdown
+        - hyperlink
+        - initials
+        - signature
+        - radio
+        - text
+        - text-merge
+    SubFormFieldsPerDocumentFontEnum:
+      type: string
+      enum:
+        - helvetica
+        - arial
+        - courier
+        - calibri
+        - cambria
+        - georgia
+        - times
+        - trebuchet
+        - verdana
+        - roboto
+        - robotoMono
+        - notoSans
+        - notoSerif
+        - notoCJK-JP-Regular
+        - notoHebrew-Regular
+        - notoSanThaiMerged
     SubFormFieldsPerDocumentBase:
       description: |-
         The fields that should appear on the document, expressed as an array of objects. (For more details you can read about it here: [Using Form Fields per Document](/docs/openapi/form-fields-per-document).)
@@ -7578,6 +7885,8 @@ components:
           description: |-
             Signer index identified by the offset in the signers parameter (0-based indexing), indicating which signer should fill out the field.
 
+            **NOTE**: To set the value of the field as the preparer you must set this to `me_now`
+
             **NOTE**: If type is `text-merge` or `checkbox-merge`, you must set this to sender in order to use pre-filled data.
           type: string
           x-int-or-string: true
@@ -7835,7 +8144,7 @@ components:
       description: |-
         An array of elements and values serialized to a string, to be used to customize the app's signer page. (Only applies to some API plans)
 
-        Take a look at our [white labeling guide](/api/reference/white-labeling/) to learn more.
+        Take a look at our [white labeling guide](https://developers.hellosign.com/api/reference/premium-branding/) to learn more.
       properties:
         header_background_color:
           type: string
@@ -7981,6 +8290,119 @@ components:
           type: boolean
           default: false
       type: object
+    TemplateCreateRequest:
+      required:
+        - signer_roles
+        - form_fields_per_document
+      properties:
+        files:
+          description: |-
+            Use `files[]` to indicate the uploaded file(s) to send for signature.
+
+            This endpoint requires either **files** or **file_urls[]**, but not both.
+          type: array
+          items:
+            type: string
+            format: binary
+        file_urls:
+          description: |-
+            Use `file_urls[]` to have Dropbox Sign download the file(s) to send for signature.
+
+            This endpoint requires either **files** or **file_urls[]**, but not both.
+          type: array
+          items:
+            type: string
+        allow_reassign:
+          description: |-
+            Allows signers to reassign their signature requests to other signers if set to `true`. Defaults to `false`.
+
+            **Note**: Only available for Premium plan and higher.
+          type: boolean
+          default: false
+        attachments:
+          description: 'A list describing the attachments'
+          type: array
+          items:
+            $ref: '#/components/schemas/SubAttachment'
+        cc_roles:
+          description: 'The CC roles that must be assigned when using the template to send a signature request'
+          type: array
+          items:
+            type: string
+        client_id:
+          description: 'Client id of the app you''re using to create this draft. Used to apply the branding and callback url defined for the app.'
+          type: string
+        field_options:
+          $ref: '#/components/schemas/SubFieldOptions'
+        form_field_groups:
+          description: 'Group information for fields defined in `form_fields_per_document`. String-indexed JSON array with `group_label` and `requirement` keys. `form_fields_per_document` must contain fields referencing a group defined in `form_field_groups`.'
+          type: array
+          items:
+            $ref: '#/components/schemas/SubFormFieldGroup'
+        form_field_rules:
+          description: 'Conditional Logic rules for fields defined in `form_fields_per_document`.'
+          type: array
+          items:
+            $ref: '#/components/schemas/SubFormFieldRule'
+        form_fields_per_document:
+          description: |-
+            The fields that should appear on the document, expressed as an array of objects. (For more details you can read about it here: [Using Form Fields per Document](/docs/openapi/form-fields-per-document).)
+
+            **NOTE**: Fields like **text**, **dropdown**, **checkbox**, **radio**, and **hyperlink** have additional required and optional parameters. Check out the list of [additional parameters](/api/reference/constants/#form-fields-per-document) for these field types.
+
+            * Text Field use `SubFormFieldsPerDocumentText`
+            * Dropdown Field use `SubFormFieldsPerDocumentDropdown`
+            * Hyperlink Field use `SubFormFieldsPerDocumentHyperlink`
+            * Checkbox Field use `SubFormFieldsPerDocumentCheckbox`
+            * Radio Field use `SubFormFieldsPerDocumentRadio`
+            * Signature Field use `SubFormFieldsPerDocumentSignature`
+            * Date Signed Field use `SubFormFieldsPerDocumentDateSigned`
+            * Initials Field use `SubFormFieldsPerDocumentInitials`
+            * Text Merge Field use `SubFormFieldsPerDocumentTextMerge`
+            * Checkbox Merge Field use `SubFormFieldsPerDocumentCheckboxMerge`
+          type: array
+          items:
+            $ref: '#/components/schemas/SubFormFieldsPerDocumentBase'
+        merge_fields:
+          description: |-
+            Add merge fields to the template. Merge fields are placed by the user creating the template and used to pre-fill data by passing values into signature requests with the `custom_fields` parameter.
+            If the signature request using that template *does not* pass a value into a merge field, then an empty field remains in the document.
+          type: array
+          items:
+            $ref: '#/components/schemas/SubMergeField'
+        message:
+          description: 'The default template email message.'
+          type: string
+          maxLength: 5000
+        metadata:
+          description: |-
+            Key-value data that should be attached to the signature request. This metadata is included in all API responses and events involving the signature request. For example, use the metadata field to store a signer's order number for look up when receiving events for the signature request.
+
+            Each request can include up to 10 metadata keys (or 50 nested metadata keys), with key names up to 40 characters long and values up to 1000 characters long.
+          type: object
+          maxItems: 10
+          additionalProperties: {}
+        signer_roles:
+          description: 'An array of the designated signer roles that must be specified when sending a SignatureRequest using this Template.'
+          type: array
+          items:
+            $ref: '#/components/schemas/SubTemplateRole'
+        subject:
+          description: 'The template title (alias).'
+          type: string
+          maxLength: 200
+        test_mode:
+          description: 'Whether this is a test, the signature request created from this draft will not be legally binding if set to `true`. Defaults to `false`.'
+          type: boolean
+          default: false
+        title:
+          description: 'The title you want to assign to the SignatureRequest.'
+          type: string
+        use_preexisting_fields:
+          description: 'Enable the detection of predefined PDF fields by setting the `use_preexisting_fields` to `true` (defaults to disabled, or `false`).'
+          type: boolean
+          default: false
+      type: object
     TemplateCreateEmbeddedDraftRequest:
       required:
         - client_id
@@ -8308,7 +8730,6 @@ components:
             **Note**: This does not correspond to the **expires_at** returned in the response.
           type: integer
           nullable: true
-          x-beta: closed
       type: object
     UnclaimedDraftCreateEmbeddedRequest:
       description: ''
@@ -8506,7 +8927,6 @@ components:
             **Note**: This does not correspond to the **expires_at** returned in the response.
           type: integer
           nullable: true
-          x-beta: closed
       type: object
     UnclaimedDraftCreateEmbeddedWithTemplateRequest:
       required:
@@ -9291,7 +9711,6 @@ components:
         expires_at:
           description: 'The time when the signature request will expire unsigned signatures. See [Signature Request Expiration Date](https://developers.hellosign.com/docs/signature-request/expiration/) for details.'
           type: integer
-          x-beta: closed
         is_complete:
           description: 'Whether or not the SignatureRequest has been fully executed by all signers.'
           type: boolean
@@ -9937,6 +10356,15 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/WarningResponse'
+          deprecated: true
+      type: object
+      x-internal: true
+    TemplateCreateResponseTemplate:
+      description: 'Template object with parameters: `template_id`.'
+      properties:
+        template_id:
+          description: 'The id of the Template.'
+          type: string
       type: object
       x-internal: true
     TemplateResponseDocument:
@@ -10639,6 +11067,7 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/WarningResponse'
+          deprecated: true
       type: object
       x-internal: true
     UnclaimedDraftResponse:
@@ -10746,6 +11175,17 @@ components:
             $ref: '#/components/schemas/WarningResponse'
       type: object
       x-internal: true
+    TemplateCreateResponse:
+      properties:
+        template:
+          $ref: '#/components/schemas/TemplateCreateResponse'
+        warnings:
+          description: 'A list of warnings.'
+          type: array
+          items:
+            $ref: '#/components/schemas/WarningResponse'
+      type: object
+      x-internal: true
     TemplateCreateEmbeddedDraftResponse:
       properties:
         template:
@@ -10924,6 +11364,22 @@ components:
       summary: 'Default Example'
       value:
         $ref: examples/json/TemplateAddUserRequestDefaultExample.json
+    TemplateCreateRequestDefaultExample:
+      summary: 'Default Example'
+      value:
+        $ref: examples/json/TemplateCreateRequestDefaultExample.json
+    TemplateCreateRequestFormFieldsPerDocumentExample:
+      summary: 'Form Fields Per Document Example'
+      value:
+        $ref: examples/json/TemplateCreateRequestFormFieldsPerDocumentExample.json
+    TemplateCreateRequestFormFieldGroupsExample:
+      summary: 'Form Fields Per Document and Groups Example'
+      value:
+        $ref: examples/json/TemplateCreateRequestFormFieldGroupsExample.json
+    TemplateCreateRequestFormFieldRulesExample:
+      summary: 'Form Fields Per Document and Rules Example'
+      value:
+        $ref: examples/json/TemplateCreateRequestFormFieldRulesExample.json
     TemplateCreateEmbeddedDraftRequestDefaultExample:
       summary: 'Default Example'
       value:
@@ -11228,6 +11684,10 @@ components:
       summary: 'Team Sub Teams List'
       value:
         $ref: examples/json/TeamSubTeamsResponseExample.json
+    TemplateCreateResponseExample:
+      summary: 'Create Template'
+      value:
+        $ref: examples/json/TemplateCreateResponseExample.json
     TemplateCreateEmbeddedDraftResponseExample:
       summary: 'Create Embedded Draft Template'
       value: