docspring 3.5.0 → 4.0.0

data/docs/TemplateDefaults.md

@@ -0,0 +1,56 @@
+# DocSpring::TemplateDefaults
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **typeface** | [**Typeface**](Typeface.md) | The font of text fields. | [optional] |
+| **font_size** | **Float** | The font size in points, a whole number. | [optional] |
+| **character_spacing** | **Float** | Extra space between characters, in points (0 to 50). | [optional] |
+| **color** | **String** | The text color, as 6 hex digits without `#`, such as `444444`. | [optional] |
+| **background_color** | **String** | The field's background color, as 6 hex digits. | [optional] |
+| **bold** | **Boolean** | Print text in bold. | [optional] |
+| **uppercase** | **Boolean** | Print text in capital letters. | [optional] |
+| **alignment** | [**TextAlignment**](TextAlignment.md) | How text is aligned in its field. `justify` lines up both edges of every line of multiline text except the last of each paragraph. | [optional] |
+| **opacity** | **Float** | The opacity of the field's content, from 0 (invisible) to 1. | [optional] |
+| **date_format** | **String** | How date fields are printed, as a strftime format such as `%m/%d/%Y`. | [optional] |
+| **date_time_format** | **String** | How date-time fields are printed, as a strftime format such as `%m/%d/%Y %H:%M:%S`. | [optional] |
+| **check_color** | **String** | The color of check marks, as 6 hex digits. | [optional] |
+| **check_character** | [**CheckCharacter**](CheckCharacter.md) | The character that a ticked check box prints. | [optional] |
+| **check_background_color** | **String** | The check box's background color, as 6 hex digits. | [optional] |
+| **required_field_background_color** | **String** | The background color that highlights required fields on visual forms and signature request forms, as 6 hex digits. PDFs don't print it. | [optional] |
+| **true_text** | **String** | The text a boolean field prints for `true`. | [optional] |
+| **false_text** | **String** | The text a boolean field prints for `false`. | [optional] |
+| **shape_fill_color** | **String** | The fill color of shapes, as 6 hex digits. | [optional] |
+| **shape_border_color** | **String** | The border color of shapes, as 6 hex digits. | [optional] |
+| **shape_border_width** | **Float** | The border width of shapes, in whole points (at least 1). | [optional] |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateDefaults.new(
+  typeface: null,
+  font_size: null,
+  character_spacing: null,
+  color: null,
+  background_color: null,
+  bold: null,
+  uppercase: null,
+  alignment: null,
+  opacity: null,
+  date_format: null,
+  date_time_format: null,
+  check_color: null,
+  check_character: null,
+  check_background_color: null,
+  required_field_background_color: null,
+  true_text: null,
+  false_text: null,
+  shape_fill_color: null,
+  shape_border_color: null,
+  shape_border_width: null
+)
+```
+

data/docs/TemplateDefaultsInput.md

@@ -0,0 +1,56 @@
+# DocSpring::TemplateDefaultsInput
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **typeface** | [**Typeface**](Typeface.md) | The font of text fields. | [optional] |
+| **font_size** | **Integer** | The font size in points, a whole number. | [optional] |
+| **character_spacing** | **Float** | Extra space between characters, in points (0 to 50). | [optional] |
+| **color** | **String** | The text color, as 6 hex digits without `#`, such as `444444`. | [optional] |
+| **background_color** | **String** | The field's background color, as 6 hex digits. | [optional] |
+| **bold** | **Boolean** | Print text in bold. | [optional] |
+| **uppercase** | **Boolean** | Print text in capital letters. | [optional] |
+| **alignment** | [**TextAlignment**](TextAlignment.md) | How text is aligned in its field. `justify` lines up both edges of every line of multiline text except the last of each paragraph. | [optional] |
+| **opacity** | **Float** | The opacity of the field's content, from 0 (invisible) to 1. | [optional] |
+| **date_format** | **String** | How date fields are printed, as a strftime format such as `%m/%d/%Y`. | [optional] |
+| **date_time_format** | **String** | How date-time fields are printed, as a strftime format such as `%m/%d/%Y %H:%M:%S`. | [optional] |
+| **check_color** | **String** | The color of check marks, as 6 hex digits. | [optional] |
+| **check_character** | [**CheckCharacter**](CheckCharacter.md) | The character that a ticked check box prints. | [optional] |
+| **check_background_color** | **String** | The check box's background color, as 6 hex digits. | [optional] |
+| **required_field_background_color** | **String** | The background color that highlights required fields on visual forms and signature request forms, as 6 hex digits. PDFs don't print it. | [optional] |
+| **true_text** | **String** | The text a boolean field prints for `true`. | [optional] |
+| **false_text** | **String** | The text a boolean field prints for `false`. | [optional] |
+| **shape_fill_color** | **String** | The fill color of shapes, as 6 hex digits. | [optional] |
+| **shape_border_color** | **String** | The border color of shapes, as 6 hex digits. | [optional] |
+| **shape_border_width** | **Integer** | The border width of shapes, in whole points (at least 1). | [optional] |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateDefaultsInput.new(
+  typeface: null,
+  font_size: null,
+  character_spacing: null,
+  color: null,
+  background_color: null,
+  bold: null,
+  uppercase: null,
+  alignment: null,
+  opacity: null,
+  date_format: null,
+  date_time_format: null,
+  check_color: null,
+  check_character: null,
+  check_background_color: null,
+  required_field_background_color: null,
+  true_text: null,
+  false_text: null,
+  shape_fill_color: null,
+  shape_border_color: null,
+  shape_border_width: null
+)
+```
+

data/docs/TemplateDocument.md

@@ -0,0 +1,40 @@
+# DocSpring::TemplateDocument
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **filename** | **String** | The PDF's file name. |  |
+| **md5** | **String** | The MD5 hash of the PDF. |  |
+| **state** | [**TemplateDocumentState**](TemplateDocumentState.md) | `pending` while DocSpring processes the PDF, then `processed`. `password_required`, `malformed_pdf` and `unknown_error` mean the PDF couldn't be processed, and `error_message` says why: upload it again or upload another one. |  |
+| **error_message** | **String** | Why the PDF couldn't be processed, and how to fix it. Null unless `state` is an error. |  |
+| **field_reimport_state** | [**FieldReimportState**](FieldReimportState.md) | Whether the fields are being re-imported from this PDF (`reimport_fields` when the PDF was replaced): `requested` while DocSpring processes the PDF, then `imported`, or `no_fields` when the PDF had no fillable fields and the template kept its fields. `none` when no re-import was asked for, or when it couldn't run (the PDF couldn't be processed, or the template was locked or published while it was). |  |
+| **page_count** | **Integer** | 0 until the PDF has been processed. |  |
+| **page_dimensions** | **Array<Array<Float>>** | Each page's width and height in PDF points. Null until the PDF has been processed. |  |
+| **has_fillable_fields** | **Boolean** | Whether the PDF has fillable form fields. Null until DocSpring has read the PDF. |  |
+| **page_processing_statuses** | [**Array<TemplatePageProcessingStatus>**](TemplatePageProcessingStatus.md) | How processing is going on each page, in page order: its image, and its fields when DocSpring sets them up (`detect_fields` when the template was created). `state` becomes `processed` once every page is done. Empty until DocSpring has read the PDF, and for PDFs uploaded before DocSpring recorded page statuses. |  |
+| **field_logic_status** | [**TemplateFieldLogicStatus**](TemplateFieldLogicStatus.md) | AI field setup's last step, which reads the whole form once every page is done and can still rename fields and add conditional logic and required fields: `pending` or `processing` until it finishes, then `processed`, `failed` or `skipped`. Null until every page is done, and when there's no logic step to run (`field_logic` is `none`, or the PDF has no fields). |  |
+| **download_url** | **String** | A temporary link to download the PDF. |  |
+| **permanent_url** | **String** | A link to download the PDF that doesn't expire. Null until the PDF has been processed. |  |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateDocument.new(
+  filename: null,
+  md5: null,
+  state: null,
+  error_message: null,
+  field_reimport_state: null,
+  page_count: null,
+  page_dimensions: null,
+  has_fillable_fields: null,
+  page_processing_statuses: null,
+  field_logic_status: null,
+  download_url: null,
+  permanent_url: null
+)
+```
+

data/docs/TemplateDocumentState.md

@@ -0,0 +1,15 @@
+# DocSpring::TemplateDocumentState
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateDocumentState.new()
+```
+

data/docs/TemplateFieldDependency.md

@@ -0,0 +1,26 @@
+# DocSpring::TemplateFieldDependency
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **action** | [**TemplateFieldDependencyAction**](TemplateFieldDependencyAction.md) | What the rule does to its targets when its conditions are met. |  |
+| **match** | [**TemplateFieldDependencyMatch**](TemplateFieldDependencyMatch.md) | Whether all of the conditions (the default) or any of them must be met. | [optional] |
+| **conditions** | [**Array<TemplateFieldDependencyCondition>**](TemplateFieldDependencyCondition.md) | The conditions on other fields' values. |  |
+| **targets** | **Array<String>** | The names of the fields the rule shows or makes required. |  |
+| **group** | **String** | Marks a rule made for a field group in the template editor. Its targets outside the group are removed when the template is saved, and the rule is removed once the group has no fields. | [optional] |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateFieldDependency.new(
+  action: null,
+  match: null,
+  conditions: null,
+  targets: null,
+  group: null
+)
+```
+

data/docs/TemplateFieldDependencyAction.md

@@ -0,0 +1,15 @@
+# DocSpring::TemplateFieldDependencyAction
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateFieldDependencyAction.new()
+```
+

data/docs/TemplateFieldDependencyCondition.md

@@ -0,0 +1,24 @@
+# DocSpring::TemplateFieldDependencyCondition
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **field** | **String** | The name of the field whose value is compared. |  |
+| **operator** | [**TemplateFieldDependencyOperator**](TemplateFieldDependencyOperator.md) | How the field's value is compared with `value`. `in`: one of a list. `range`: from `value` to `range_max`. |  |
+| **value** | **Object** | The value to compare the field's value with. | [optional] |
+| **range_max** | **Object** | The upper end of a `range`, a number (or a number as a string, as the template editor saves it). | [optional] |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateFieldDependencyCondition.new(
+  field: null,
+  operator: null,
+  value: null,
+  range_max: null
+)
+```
+

data/docs/TemplateFieldDependencyConditionInput.md

@@ -0,0 +1,93 @@
+# DocSpring::TemplateFieldDependencyConditionInput
+
+## Class instance methods
+
+### `openapi_one_of`
+
+Returns the list of classes defined in oneOf.
+
+#### Example
+
+```ruby
+require 'docspring'
+
+DocSpring::TemplateFieldDependencyConditionInput.openapi_one_of
+# =>
+# [
+#   :'FieldComparisonCondition',
+#   :'FieldEqualsCondition',
+#   :'FieldInCondition',
+#   :'FieldPresenceCondition',
+#   :'FieldRangeCondition'
+# ]
+```
+
+### `openapi_discriminator_name`
+
+Returns the discriminator's property name.
+
+#### Example
+
+```ruby
+require 'docspring'
+
+DocSpring::TemplateFieldDependencyConditionInput.openapi_discriminator_name
+# => :'operator'
+```
+
+### `openapi_discriminator_name`
+
+Returns the discriminator's mapping.
+
+#### Example
+
+```ruby
+require 'docspring'
+
+DocSpring::TemplateFieldDependencyConditionInput.openapi_discriminator_mapping
+# =>
+# {
+#   :'blank' => :'FieldPresenceCondition',
+#   :'equals' => :'FieldEqualsCondition',
+#   :'gt' => :'FieldComparisonCondition',
+#   :'gte' => :'FieldComparisonCondition',
+#   :'in' => :'FieldInCondition',
+#   :'lt' => :'FieldComparisonCondition',
+#   :'lte' => :'FieldComparisonCondition',
+#   :'not_equals' => :'FieldEqualsCondition',
+#   :'present' => :'FieldPresenceCondition',
+#   :'range' => :'FieldRangeCondition'
+# }
+```
+
+### build
+
+Find the appropriate object from the `openapi_one_of` list and casts the data into it.
+
+#### Example
+
+```ruby
+require 'docspring'
+
+DocSpring::TemplateFieldDependencyConditionInput.build(data)
+# => #<FieldComparisonCondition:0x00007fdd4aab02a0>
+
+DocSpring::TemplateFieldDependencyConditionInput.build(data_that_doesnt_match)
+# => nil
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| **data** | **Mixed** | data to be matched against the list of oneOf items |
+
+#### Return type
+
+- `FieldComparisonCondition`
+- `FieldEqualsCondition`
+- `FieldInCondition`
+- `FieldPresenceCondition`
+- `FieldRangeCondition`
+- `nil` (if no type matches)
+

data/docs/TemplateFieldDependencyInput.md

@@ -0,0 +1,26 @@
+# DocSpring::TemplateFieldDependencyInput
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **action** | [**TemplateFieldDependencyAction**](TemplateFieldDependencyAction.md) | What the rule does to its targets when its conditions are met. |  |
+| **match** | [**TemplateFieldDependencyMatch**](TemplateFieldDependencyMatch.md) | Whether all of the conditions (the default) or any of them must be met. | [optional] |
+| **conditions** | [**Array<TemplateFieldDependencyConditionInput>**](TemplateFieldDependencyConditionInput.md) | The conditions on other fields' values. |  |
+| **targets** | **Array<String>** | The names of the fields the rule shows or makes required. |  |
+| **group** | **String** | Marks a rule made for a field group in the template editor. Its targets outside the group are removed when the template is saved, and the rule is removed once the group has no fields. | [optional] |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateFieldDependencyInput.new(
+  action: null,
+  match: null,
+  conditions: null,
+  targets: null,
+  group: null
+)
+```
+

data/docs/TemplateFieldDependencyMatch.md

@@ -0,0 +1,15 @@
+# DocSpring::TemplateFieldDependencyMatch
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateFieldDependencyMatch.new()
+```
+

data/docs/TemplateFieldDependencyOperator.md

@@ -0,0 +1,15 @@
+# DocSpring::TemplateFieldDependencyOperator
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateFieldDependencyOperator.new()
+```
+

data/docs/TemplateFieldLogicStatus.md

@@ -0,0 +1,15 @@
+# DocSpring::TemplateFieldLogicStatus
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateFieldLogicStatus.new()
+```
+

data/docs/TemplateFormMode.md

@@ -0,0 +1,15 @@
+# DocSpring::TemplateFormMode
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateFormMode.new()
+```
+

data/docs/TemplateModelCode.md

@@ -0,0 +1,22 @@
+# DocSpring::TemplateModelCode
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **lang** | [**ModelCodeLanguage**](ModelCodeLanguage.md) | The language of `code`. |  |
+| **root_type_name** | **String** | The name of the type for the whole submission data object. |  |
+| **code** | **String** | The source code of the types, starting with `root_type_name`. |  |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateModelCode.new(
+  lang: null,
+  root_type_name: null,
+  code: null
+)
+```
+

data/docs/TemplatePageAiError.md

@@ -0,0 +1,15 @@
+# DocSpring::TemplatePageAiError
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplatePageAiError.new()
+```
+

data/docs/TemplatePageAiNamingStatus.md

@@ -0,0 +1,15 @@
+# DocSpring::TemplatePageAiNamingStatus
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplatePageAiNamingStatus.new()
+```
+

data/docs/TemplatePageFieldsStatus.md

@@ -0,0 +1,15 @@
+# DocSpring::TemplatePageFieldsStatus
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplatePageFieldsStatus.new()
+```
+

data/docs/TemplatePageImageStatus.md

@@ -0,0 +1,15 @@
+# DocSpring::TemplatePageImageStatus
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplatePageImageStatus.new()
+```
+

data/docs/TemplatePageProcessingStatus.md

@@ -0,0 +1,26 @@
+# DocSpring::TemplatePageProcessingStatus
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **image** | [**TemplatePageImageStatus**](TemplatePageImageStatus.md) | The page's image, which the template editor shows. `pending` until it's rendered. |  |
+| **fields** | [**TemplatePageFieldsStatus**](TemplatePageFieldsStatus.md) | Setting up the page's fields: `pending` while they're imported or detected, `naming` while AI names them, then `processed` or `failed`. `disabled` when DocSpring doesn't set up the page's fields. |  |
+| **ai_naming** | [**TemplatePageAiNamingStatus**](TemplatePageAiNamingStatus.md) | `failed` or `skipped` when AI didn't name the page's fields as asked (`ai_error` says why), and the fields kept plain names. Null otherwise. |  |
+| **ai_error** | [**TemplatePageAiError**](TemplatePageAiError.md) | Why AI naming failed or was skipped: `unavailable` (the AI service was unavailable: set up the fields again later), `error`, `credits` (the account had no free AI pages or credits left) or `skipped` (someone skipped AI setup in the template editor). Null when `ai_naming` is. |  |
+| **detected_boxes** | **Array<Array<Float>>** | While AI names the page's fields, the boxes field detection found: `[x, y, width, height]` in PDF points from the page's top-left corner. Null otherwise. |  |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplatePageProcessingStatus.new(
+  image: null,
+  fields: null,
+  ai_naming: null,
+  ai_error: null,
+  detected_boxes: null
+)
+```
+

data/docs/TemplateSourcePdf.md

@@ -0,0 +1,24 @@
+# DocSpring::TemplateSourcePdf
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **type** | **String** | Must be `template`. | [default to 'template'] |
+| **id** | **String** | The ID of the submission, combined PDF, template or custom file. |  |
+| **template_version** | **String** | For a `template` source, the version to use: a published version (`1.2.0`, or `1` for the latest 1.x.x), `latest` or `draft`. Default `latest` (the draft when no version has been published). | [optional] |
+| **processed** | **Boolean** | For a `template` source: true (the default) merges the template's processed PDF, which is the PDF submissions are filled in on (decrypted, with its form fields removed). false merges the PDF as it was uploaded. | [optional] |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateSourcePdf.new(
+  type: null,
+  id: null,
+  template_version: null,
+  processed: null
+)
+```
+

data/docs/TemplateSummary.md

@@ -0,0 +1,90 @@
+# DocSpring::TemplateSummary
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | The template's ID. |  |
+| **name** | **String** | The template's name. |  |
+| **description** | **String** | Shown under the template's name at the top of its hosted forms, and used as their meta description. Not shown on embedded forms or signature requests. |  |
+| **template_type** | [**TemplateType**](TemplateType.md) | `pdf`: fields placed on an uploaded PDF. `html`: a PDF rendered from HTML and SCSS. It can't be changed after the template is created. |  |
+| **ready** | **Boolean** | Whether the template can generate PDFs. HTML templates are always ready. A PDF template is ready once its document has been processed (`document.state` is `processed`). |  |
+| **document** | [**TemplateDocument**](TemplateDocument.md) | The PDF of a PDF template. Null for HTML templates, and for a PDF template that has no PDF yet. |  |
+| **parent_folder_id** | **String** | The ID of the folder the template is in. Null for a template at the root. Setting it moves the template and all of its published versions. |  |
+| **path** | **String** | The path of the folder the template is in, such as `/Contracts`. `/` for a template at the root. |  |
+| **version** | **String** | The published version this is, such as `1.2.0`. Null for the draft. |  |
+| **latest_version** | **String** | The template's latest published version. Null if no version has been published. |  |
+| **version_published_at** | **Time** | When this version was published. Null for the draft. |  |
+| **locked** | **Boolean** | A locked template can't be changed or deleted until it's unlocked (`locked` can always be changed). |  |
+| **add_signature_request_submission_id_footers** | **Boolean** | Print the submission ID in the footer of each page of PDFs signed through signature requests. |  |
+| **ai_field_naming_language** | [**AiFieldNamingLanguage**](AiFieldNamingLanguage.md) | The language AI field setup names fields in: `auto` uses the form's language when it's written in the Latin alphabet without accents, and English otherwise; `english` always uses English; `form_language` uses the form's language and script. New templates take it from your account's template settings. Null for HTML templates. |  |
+| **allow_additional_properties** | **Boolean** | Accept submission data with properties that aren't fields of the template. |  |
+| **allow_skipping_optional_fields** | **Boolean** | Visual forms and signature request forms show the Continue button as soon as the required fields are filled in, without visiting each optional field. The `allowSkippingOptionalFields` embed option overrides it. |  |
+| **default_form_mode** | [**TemplateFormMode**](TemplateFormMode.md) | The hosted form that /templates/{template_id}/form shows when its URL has no `mode` parameter: `web` (the web form), `visual` (the visual form, where fields are filled in on the PDF) or `dual` (both, in tabs). HTML templates have no visual form, so `web` is the only value they accept. |  |
+| **editable_submissions** | **Boolean** | Generate PDFs whose text and check fields stay fillable ("Generate Editable PDFs"). A submission's `editable` overrides it. |  |
+| **embed_domains** | **Array<String>** | The sites where the template's signature requests, forms and embedded template editor can be loaded: a host such as `app.example.com`, with an optional leading wildcard (`*.example.com`), port (`localhost:3000`) or scheme (`https://app.example.com`; without one, `http` and `https` both work). When it's empty, live signature requests don't load on any site, and the embedded template editor loads on every site. |  |
+| **embed_edit_allow_settings** | **Boolean** | Allow the embedded template editor to change sensitive template settings (webhooks, redirect URL, encryption, public access, expiration and so on). |  |
+| **embed_edit_allow_versioning** | **Boolean** | Allow the embedded template editor to publish, restore, compare and delete published versions. |  |
+| **embed_edit_allow_document_replacement** | **Boolean** | Allow the embedded template editor to replace the template's PDF. |  |
+| **encrypt_pdfs** | **Boolean** | Encrypt generated PDFs with `encrypt_pdfs_password`. |  |
+| **has_encrypt_pdfs_password** | **Boolean** | Whether `encrypt_pdfs_password` is set. |  |
+| **expire_submissions** | **Boolean** | Delete each submission's data and PDF after `expire_after` `expiration_interval`. |  |
+| **expire_after** | **Integer** | How many `expiration_interval`s a submission's data and PDF are kept for, when `expire_submissions` is on. At most 5256000 (10 years in minutes). |  |
+| **expiration_interval** | [**ExpirationInterval**](ExpirationInterval.md) | The unit of `expire_after`. |  |
+| **merge_audit_trail_pdf** | **Boolean** | Add the audit trail to the end of PDFs signed through signature requests. |  |
+| **parse_dates_using_template_date_format** | **Boolean** | Date fields also accept NN/NN/YYYY dates (with slashes, dashes or dots), read in the order of the template's default date format: month first for %m/%d/%Y, day first for %d/%m/%Y. When false, date fields only accept YYYY-MM-DD. Applies to PDF templates: an HTML template's date fields only accept YYYY-MM-DD. Date fields that include a time take RFC 3339 date-times either way. |  |
+| **public_submissions** | **Boolean** | Allow anyone with a submission's ID to download its PDF. |  |
+| **public_web_form** | **Boolean** | Allow anyone to fill in the template's web form. |  |
+| **redirect_url** | **String** | Where the web form sends people after they submit it. |  |
+| **has_slack_webhook_url** | **Boolean** | Whether `slack_webhook_url` is set. |  |
+| **last_changed_at** | **Time** | When the draft was last changed. |  |
+| **last_changed_by** | [**TemplateActor**](TemplateActor.md) | Who last changed the draft: a user in your account, an API token, or someone using the embedded template editor. Null if no change has been recorded. |  |
+| **created_at** | **Time** | When the template was created. |  |
+| **updated_at** | **Time** | When the template was last updated. |  |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::TemplateSummary.new(
+  id: null,
+  name: null,
+  description: null,
+  template_type: null,
+  ready: null,
+  document: null,
+  parent_folder_id: null,
+  path: null,
+  version: null,
+  latest_version: null,
+  version_published_at: null,
+  locked: null,
+  add_signature_request_submission_id_footers: null,
+  ai_field_naming_language: null,
+  allow_additional_properties: null,
+  allow_skipping_optional_fields: null,
+  default_form_mode: null,
+  editable_submissions: null,
+  embed_domains: null,
+  embed_edit_allow_settings: null,
+  embed_edit_allow_versioning: null,
+  embed_edit_allow_document_replacement: null,
+  encrypt_pdfs: null,
+  has_encrypt_pdfs_password: null,
+  expire_submissions: null,
+  expire_after: null,
+  expiration_interval: null,
+  merge_audit_trail_pdf: null,
+  parse_dates_using_template_date_format: null,
+  public_submissions: null,
+  public_web_form: null,
+  redirect_url: null,
+  has_slack_webhook_url: null,
+  last_changed_at: null,
+  last_changed_by: null,
+  created_at: null,
+  updated_at: null
+)
+```
+