docspring 4.0.0 → 4.2.0

data/docs/Client.md

@@ -4,6 +4,7 @@ All URIs are relative to *https://sync.api.docspring.com/api/v2*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**add_template_fields**](Client.md#add_template_fields) | **POST** /templates/{template_id}/fields | Add fields to a template |
 | [**copy_template**](Client.md#copy_template) | **POST** /templates/{template_id}/copy | Copy a template |
 | [**create_combined_pdf**](Client.md#create_combined_pdf) | **POST** /combined_pdfs | Combine PDFs |
 | [**create_custom_file_from_upload**](Client.md#create_custom_file_from_upload) | **POST** /custom_files | Create a custom file from an upload |
@@ -13,6 +14,7 @@ All URIs are relative to *https://sync.api.docspring.com/api/v2*
 | [**create_submission**](Client.md#create_submission) | **POST** /templates/{template_id}/submissions | Generate a PDF |
 | [**create_submission_batch**](Client.md#create_submission_batch) | **POST** /submissions/batches | Generate PDFs in a batch |
 | [**create_template**](Client.md#create_template) | **POST** /templates | Create a template |
+| [**create_template_preview**](Client.md#create_template_preview) | **POST** /templates/{template_id}/previews | Preview a template with data |
 | [**create_webhook**](Client.md#create_webhook) | **POST** /webhooks | Create a webhook |
 | [**delete_custom_file**](Client.md#delete_custom_file) | **DELETE** /custom_files/{custom_file_id} | Delete a custom file |
 | [**delete_folder**](Client.md#delete_folder) | **DELETE** /folders/{folder_id} | Delete a folder |
@@ -20,6 +22,7 @@ All URIs are relative to *https://sync.api.docspring.com/api/v2*
 | [**delete_webhook**](Client.md#delete_webhook) | **DELETE** /webhooks/{webhook_id} | Delete a webhook |
 | [**expire_combined_pdf**](Client.md#expire_combined_pdf) | **DELETE** /combined_pdfs/{combined_pdf_id} | Expire a combined PDF |
 | [**expire_submission**](Client.md#expire_submission) | **DELETE** /submissions/{submission_id} | Expire a submission |
+| [**generate_submission_files**](Client.md#generate_submission_files) | **POST** /submissions/{submission_id}/generate_files | Generate more files |
 | [**generate_submission_preview**](Client.md#generate_submission_preview) | **POST** /submissions/{submission_id}/generate_preview | Generate a preview PDF |
 | [**get_combined_pdf**](Client.md#get_combined_pdf) | **GET** /combined_pdfs/{combined_pdf_id} | Get a combined PDF |
 | [**get_custom_file**](Client.md#get_custom_file) | **GET** /custom_files/{custom_file_id} | Get a custom file |
@@ -29,28 +32,108 @@ All URIs are relative to *https://sync.api.docspring.com/api/v2*
 | [**get_submission**](Client.md#get_submission) | **GET** /submissions/{submission_id} | Get a submission |
 | [**get_submission_batch**](Client.md#get_submission_batch) | **GET** /submissions/batches/{submission_batch_id} | Get a batch |
 | [**get_template**](Client.md#get_template) | **GET** /templates/{template_id} | Get a template |
+| [**get_template_diff**](Client.md#get_template_diff) | **GET** /templates/{template_id}/diff | Compare a version of a template with the one before it |
 | [**get_template_model_code**](Client.md#get_template_model_code) | **GET** /templates/{template_id}/model_code | Generate typed code for a template's submission data |
+| [**get_template_page_images**](Client.md#get_template_page_images) | **GET** /templates/{template_id}/page_images | Get images of a template's pages |
+| [**get_template_preview**](Client.md#get_template_preview) | **GET** /templates/{template_id}/previews/{preview_id} | Get a template preview |
 | [**get_template_schema**](Client.md#get_template_schema) | **GET** /templates/{template_id}/schema | Get the JSON Schema of a template's submission data |
 | [**get_webhook**](Client.md#get_webhook) | **GET** /webhooks/{webhook_id} | Get a webhook |
 | [**list_combined_pdfs**](Client.md#list_combined_pdfs) | **GET** /combined_pdfs | List combined PDFs |
 | [**list_custom_files**](Client.md#list_custom_files) | **GET** /custom_files | List custom files |
 | [**list_folders**](Client.md#list_folders) | **GET** /folders | List folders |
 | [**list_submissions**](Client.md#list_submissions) | **GET** /submissions | List submissions |
+| [**list_template_fields**](Client.md#list_template_fields) | **GET** /templates/{template_id}/fields | List a template's fields |
 | [**list_template_submissions**](Client.md#list_template_submissions) | **GET** /templates/{template_id}/submissions | List a template's submissions |
 | [**list_templates**](Client.md#list_templates) | **GET** /templates | List templates |
 | [**list_webhooks**](Client.md#list_webhooks) | **GET** /webhooks | List webhooks |
 | [**move_folder**](Client.md#move_folder) | **POST** /folders/{folder_id}/move | Move a folder |
 | [**move_template**](Client.md#move_template) | **POST** /templates/{template_id}/move | Move a template to a folder |
 | [**publish_template_version**](Client.md#publish_template_version) | **POST** /templates/{template_id}/publish_version | Publish a template version |
+| [**remove_template_fields**](Client.md#remove_template_fields) | **POST** /templates/{template_id}/fields/remove | Remove fields from a template |
 | [**rename_folder**](Client.md#rename_folder) | **POST** /folders/{folder_id}/rename | Rename a folder |
+| [**reorder_template_fields**](Client.md#reorder_template_fields) | **POST** /templates/{template_id}/fields/reorder | Reorder a template's fields |
 | [**restore_template_version**](Client.md#restore_template_version) | **POST** /templates/{template_id}/restore_version | Restore a template version |
 | [**test_authentication**](Client.md#test_authentication) | **GET** /authentication | Test authentication |
 | [**update_signature_request**](Client.md#update_signature_request) | **PUT** /signature_requests/{signature_request_id} | Update a signature request |
 | [**update_template**](Client.md#update_template) | **PUT** /templates/{template_id} | Update a template |
 | [**update_template_document**](Client.md#update_template_document) | **PUT** /templates/{template_id}/document | Replace a template's PDF |
+| [**update_template_fields**](Client.md#update_template_fields) | **PUT** /templates/{template_id}/fields | Update a template's fields |
 | [**update_webhook**](Client.md#update_webhook) | **PUT** /webhooks/{webhook_id} | Update a webhook |
 | [**upload_template**](Client.md#upload_template) | **POST** /templates/upload | Create a PDF template from an uploaded PDF |
 | [**upload_template_document**](Client.md#upload_template_document) | **PUT** /templates/{template_id}/document/upload | Replace a template's PDF with an uploaded PDF |
+| [**validate_submission**](Client.md#validate_submission) | **POST** /templates/{template_id}/submissions/validate | Check a submission without creating it |
+
+
+## add_template_fields
+
+> <TemplateFields> add_template_fields(template_id, body)
+
+Add fields to a template
+
+Adds fields to a template's draft and returns all of its fields. Publish a version for submissions of published versions to have them. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
+body = DocSpring::AddTemplateFieldsRequest.new({fields: [DocSpring::FieldInput.new]}) # AddTemplateFieldsRequest | The fields to add to the template's draft.
+
+begin
+  # Add fields to a template
+  result = api_instance.add_template_fields(template_id, body)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->add_template_fields: #{e}"
+end
+```
+
+#### Using the add_template_fields_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplateFields>, Integer, Hash)> add_template_fields_with_http_info(template_id, body)
+
+```ruby
+begin
+  # Add fields to a template
+  data, status_code, headers = api_instance.add_template_fields_with_http_info(template_id, body)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplateFields>
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->add_template_fields_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **template_id** | **String** | The template's ID. |  |
+| **body** | [**AddTemplateFieldsRequest**](AddTemplateFieldsRequest.md) | The fields to add to the template's draft. |  |
+
+### Return type
+
+[**TemplateFields**](TemplateFields.md)
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
 
 
 ## copy_template
@@ -150,7 +233,8 @@ end
 api_instance = DocSpring::Client.new
 body = DocSpring::CreateCombinedPdfRequest.new({source_pdfs: [DocSpring::CombinedPdfSourcePdf.new({type: 'type_example', id: 'id_example'})]}) # CreateCombinedPdfRequest | The PDFs to merge, and the combined PDF's settings.
 opts = {
-  wait: true # Boolean | Wait until the PDF has been generated before responding. Default true on sync.api hosts.
+  wait: true, # Boolean | Wait until the PDF has been generated before responding. Default true on sync.api hosts.
+  idempotency_key: 'idempotency_key_example' # String | A key of your own, such as a UUID, that makes it safe to send this request again: for 24 hours, DocSpring answers a request with the same key from the same API token with the first request's response (and an `Idempotent-Replayed: true` header) instead of creating another combined PDF. Send a new key with each new combined PDF, and the same key each time you send the same request again, such as after a timeout, a network error or a 5xx. The same key with a different request is a 422 `idempotency_key_reused`. A 409 `idempotency_key_in_use` means the first request is still being processed: send the request again in a few seconds.
 }
 
 begin
@@ -186,6 +270,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **body** | [**CreateCombinedPdfRequest**](CreateCombinedPdfRequest.md) | The PDFs to merge, and the combined PDF's settings. |  |
 | **wait** | **Boolean** | Wait until the PDF has been generated before responding. Default true on sync.api hosts. | [optional] |
+| **idempotency_key** | **String** | A key of your own, such as a UUID, that makes it safe to send this request again: for 24 hours, DocSpring answers a request with the same key from the same API token with the first request's response (and an `Idempotent-Replayed: true` header) instead of creating another combined PDF. Send a new key with each new combined PDF, and the same key each time you send the same request again, such as after a timeout, a network error or a 5xx. The same key with a different request is a 422 `idempotency_key_reused`. A 409 `idempotency_key_in_use` means the first request is still being processed: send the request again in a few seconds. | [optional] |
 
 ### Return type
 
@@ -347,7 +432,7 @@ end
 
 Record a signature request event
 
-Records something that happened outside DocSpring in the signature request's audit trail: you sent the request to the person (`send_request`). The audit trail shows it as reported by your account. 
+Records something that happened outside DocSpring in the signature request's audit trail: you sent the request to the person (`send_request`). The audit trail shows it as reported by your account. A finished (completed, declined or expired) signature request's audit trail takes no more events, and a test API token can't record one for a live signature request. 
 
 ### Examples
 
@@ -512,7 +597,8 @@ template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
 body = DocSpring::CreateSubmissionRequest.new # CreateSubmissionRequest | The submission's data and settings.
 opts = {
   version: 'version_example', # String | The template 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).
-  wait: true # Boolean | Wait until the PDF has been generated before responding. Default true on sync.api hosts.
+  wait: true, # Boolean | Wait until the files have been generated before responding. Default true on sync.api hosts.
+  idempotency_key: 'idempotency_key_example' # String | A key of your own, such as a UUID, that makes it safe to send this request again: for 24 hours, DocSpring answers a request with the same key from the same API token with the first request's response (and an `Idempotent-Replayed: true` header) instead of creating another submission. Send a new key with each new submission, and the same key each time you send the same request again, such as after a timeout, a network error or a 5xx. The same key with a different request is a 422 `idempotency_key_reused`. A 409 `idempotency_key_in_use` means the first request is still being processed: send the request again in a few seconds.
 }
 
 begin
@@ -549,7 +635,8 @@ end
 | **template_id** | **String** | The template's ID. |  |
 | **body** | [**CreateSubmissionRequest**](CreateSubmissionRequest.md) | The submission's data and settings. |  |
 | **version** | **String** | The template 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] |
-| **wait** | **Boolean** | Wait until the PDF has been generated before responding. Default true on sync.api hosts. | [optional] |
+| **wait** | **Boolean** | Wait until the files have been generated before responding. Default true on sync.api hosts. | [optional] |
+| **idempotency_key** | **String** | A key of your own, such as a UUID, that makes it safe to send this request again: for 24 hours, DocSpring answers a request with the same key from the same API token with the first request's response (and an `Idempotent-Replayed: true` header) instead of creating another submission. Send a new key with each new submission, and the same key each time you send the same request again, such as after a timeout, a network error or a 5xx. The same key with a different request is a 422 `idempotency_key_reused`. A 409 `idempotency_key_in_use` means the first request is still being processed: send the request again in a few seconds. | [optional] |
 
 ### Return type
 
@@ -588,7 +675,8 @@ end
 api_instance = DocSpring::Client.new
 body = DocSpring::CreateSubmissionBatchRequest.new({submissions: [DocSpring::SubmissionInput.new]}) # CreateSubmissionBatchRequest | The submissions to create, and the settings they share.
 opts = {
-  wait: true # Boolean | Wait until every PDF in the batch has been generated before responding. Default true on sync.api hosts.
+  wait: true, # Boolean | Wait until every PDF in the batch has been generated before responding. Default true on sync.api hosts.
+  idempotency_key: 'idempotency_key_example' # String | A key of your own, such as a UUID, that makes it safe to send this request again: for 24 hours, DocSpring answers a request with the same key from the same API token with the first request's response (and an `Idempotent-Replayed: true` header) instead of creating another batch. Send a new key with each new batch, and the same key each time you send the same request again, such as after a timeout, a network error or a 5xx. The same key with a different request is a 422 `idempotency_key_reused`. A 409 `idempotency_key_in_use` means the first request is still being processed: send the request again in a few seconds.
 }
 
 begin
@@ -624,6 +712,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **body** | [**CreateSubmissionBatchRequest**](CreateSubmissionBatchRequest.md) | The submissions to create, and the settings they share. |  |
 | **wait** | **Boolean** | Wait until every PDF in the batch has been generated before responding. Default true on sync.api hosts. | [optional] |
+| **idempotency_key** | **String** | A key of your own, such as a UUID, that makes it safe to send this request again: for 24 hours, DocSpring answers a request with the same key from the same API token with the first request's response (and an `Idempotent-Replayed: true` header) instead of creating another batch. Send a new key with each new batch, and the same key each time you send the same request again, such as after a timeout, a network error or a 5xx. The same key with a different request is a 422 `idempotency_key_reused`. A 409 `idempotency_key_in_use` means the first request is still being processed: send the request again in a few seconds. | [optional] |
 
 ### Return type
 
@@ -662,7 +751,7 @@ end
 api_instance = DocSpring::Client.new
 body = DocSpring::CreateTemplateRequest.new({template_type: DocSpring::TemplateType::PDF}) # CreateTemplateRequest | The template to create.
 opts = {
-  wait: true # Boolean | Wait until the PDF has been processed before responding. Default true on sync.api hosts.
+  wait: true # Boolean | Wait until the PDF has been processed, and a `document_url` downloaded, before responding. Default true on sync.api hosts.
 }
 
 begin
@@ -697,7 +786,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **body** | [**CreateTemplateRequest**](CreateTemplateRequest.md) | The template to create. |  |
-| **wait** | **Boolean** | Wait until the PDF has been processed before responding. Default true on sync.api hosts. | [optional] |
+| **wait** | **Boolean** | Wait until the PDF has been processed, and a `document_url` downloaded, before responding. Default true on sync.api hosts. | [optional] |
 
 ### Return type
 
@@ -713,6 +802,82 @@ end
 - **Accept**: application/json
 
 
+## create_template_preview
+
+> <TemplatePreview> create_template_preview(template_id, body, opts)
+
+Preview a template with data
+
+Makes PNG images of a template's pages filled in with the data you send (not a PDF), so you can check how an HTML or PDF template prints with your data before you publish a version or send live data. It renders the template's draft, or the published `version` you ask for. A preview makes no submission and uses no credits, and its pages are watermarked like a test submission's PDF. It's `pending` while it renders: get it with GET /templates/{template_id}/previews/{preview_id} until it's `processed`, with an image of each page, or `error`. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+template_id = 'tpl_1234567890abcdef02' # String | The template's ID.
+body = DocSpring::CreateTemplatePreviewRequest.new({data: { key: 3.56}}) # CreateTemplatePreviewRequest | The data to render the template with.
+opts = {
+  version: 'version_example' # String | A published version (`1.2.0`, or `1` for the latest 1.x.x), `latest` or `draft`. Default `draft`.
+}
+
+begin
+  # Preview a template with data
+  result = api_instance.create_template_preview(template_id, body, opts)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->create_template_preview: #{e}"
+end
+```
+
+#### Using the create_template_preview_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplatePreview>, Integer, Hash)> create_template_preview_with_http_info(template_id, body, opts)
+
+```ruby
+begin
+  # Preview a template with data
+  data, status_code, headers = api_instance.create_template_preview_with_http_info(template_id, body, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplatePreview>
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->create_template_preview_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **template_id** | **String** | The template's ID. |  |
+| **body** | [**CreateTemplatePreviewRequest**](CreateTemplatePreviewRequest.md) | The data to render the template with. |  |
+| **version** | **String** | A published version (`1.2.0`, or `1` for the latest 1.x.x), `latest` or `draft`. Default `draft`. | [optional] |
+
+### Return type
+
+[**TemplatePreview**](TemplatePreview.md)
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## create_webhook
 
 > <Webhook> create_webhook(body)
@@ -1207,6 +1372,82 @@ end
 - **Accept**: application/json
 
 
+## generate_submission_files
+
+> <Submission> generate_submission_files(submission_id, body, opts)
+
+Generate more files
+
+Adds formats to a processed submission's files, in the background: `png`, a PNG image of each page of the PDF (up to 100 pages). To make them with the submission, add them to `output_formats` when you create it.  Each new file is listed in `files` while it's made: on sync.api hosts the request waits for them (unless you pass `wait=false`), otherwise poll GET /submissions/{submission_id} until none of their `state` is `pending`. A file that couldn't be made has the state `error` and an `error_message`, and the submission stays processed. Asking for a format the submission already has (or is making) changes nothing. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+submission_id = 'sub_1234567890abcdef01' # String | The submission's ID.
+body = DocSpring::GenerateSubmissionFilesRequest.new({formats: [DocSpring::GenerateFilesFormat::PNG]}) # GenerateSubmissionFilesRequest | The formats to make.
+opts = {
+  wait: true # Boolean | Wait until the files have been generated before responding. Default true on sync.api hosts.
+}
+
+begin
+  # Generate more files
+  result = api_instance.generate_submission_files(submission_id, body, opts)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->generate_submission_files: #{e}"
+end
+```
+
+#### Using the generate_submission_files_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<Submission>, Integer, Hash)> generate_submission_files_with_http_info(submission_id, body, opts)
+
+```ruby
+begin
+  # Generate more files
+  data, status_code, headers = api_instance.generate_submission_files_with_http_info(submission_id, body, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <Submission>
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->generate_submission_files_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **submission_id** | **String** | The submission's ID. |  |
+| **body** | [**GenerateSubmissionFilesRequest**](GenerateSubmissionFilesRequest.md) | The formats to make. |  |
+| **wait** | **Boolean** | Wait until the files have been generated before responding. Default true on sync.api hosts. | [optional] |
+
+### Return type
+
+[**Submission**](Submission.md)
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## generate_submission_preview
 
 > <Submission> generate_submission_preview(submission_id)
@@ -1842,13 +2083,13 @@ end
 - **Accept**: application/json
 
 
-## get_template_model_code
+## get_template_diff
 
-> <TemplateModelCode> get_template_model_code(template_id, lang, opts)
+> <TemplateDiff> get_template_diff(template_id, opts)
 
-Generate typed code for a template's submission data
+Compare a version of a template with the one before it
 
-Generates types for a template's submission data in TypeScript, JavaScript, Ruby, Python, PHP, Java, C#, Elixir or Go, so your app catches mistakes before it calls the API. `root_type_name` is the type of the whole `data` object. Java returns every class in `code`, each under a `// ClassName.java` comment. A template with no named fields returns 422. 
+Returns what changed in the template's draft since its latest published version (or in a published version since the one before it): fields added, removed, changed and moved, the settings that changed, and whether the document was replaced. Check it before you publish a version. 
 
 ### Examples
 
@@ -1864,35 +2105,34 @@ end
 
 api_instance = DocSpring::Client.new
 template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
-lang = DocSpring::ModelCodeLanguage::TYPESCRIPT # ModelCodeLanguage | The language to generate the code in.
 opts = {
-  version: 'draft' # String | The template version: 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), the version a submission uses by default.
+  version: '0.1.0' # String | A published version (`1.2.0`, or `1` for the latest 1.x.x), `latest` or `draft`. Default `draft`.
 }
 
 begin
-  # Generate typed code for a template's submission data
-  result = api_instance.get_template_model_code(template_id, lang, opts)
+  # Compare a version of a template with the one before it
+  result = api_instance.get_template_diff(template_id, opts)
   p result
 rescue DocSpring::ApiError => e
-  puts "Error when calling Client->get_template_model_code: #{e}"
+  puts "Error when calling Client->get_template_diff: #{e}"
 end
 ```
 
-#### Using the get_template_model_code_with_http_info variant
+#### Using the get_template_diff_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<TemplateModelCode>, Integer, Hash)> get_template_model_code_with_http_info(template_id, lang, opts)
+> <Array(<TemplateDiff>, Integer, Hash)> get_template_diff_with_http_info(template_id, opts)
 
 ```ruby
 begin
-  # Generate typed code for a template's submission data
-  data, status_code, headers = api_instance.get_template_model_code_with_http_info(template_id, lang, opts)
+  # Compare a version of a template with the one before it
+  data, status_code, headers = api_instance.get_template_diff_with_http_info(template_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <TemplateModelCode>
+  p data # => <TemplateDiff>
 rescue DocSpring::ApiError => e
-  puts "Error when calling Client->get_template_model_code_with_http_info: #{e}"
+  puts "Error when calling Client->get_template_diff_with_http_info: #{e}"
 end
 ```
 
@@ -1901,12 +2141,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **template_id** | **String** | The template's ID. |  |
-| **lang** | [**ModelCodeLanguage**](.md) | The language to generate the code in. |  |
-| **version** | **String** | The template version: 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), the version a submission uses by default. | [optional] |
+| **version** | **String** | A published version (`1.2.0`, or `1` for the latest 1.x.x), `latest` or `draft`. Default `draft`. | [optional] |
 
 ### Return type
 
-[**TemplateModelCode**](TemplateModelCode.md)
+[**TemplateDiff**](TemplateDiff.md)
 
 ### Authorization
 
@@ -1918,13 +2157,13 @@ end
 - **Accept**: application/json
 
 
-## get_template_schema
+## get_template_model_code
 
-> Hash&lt;String, Object&gt; get_template_schema(template_id, opts)
+> <TemplateModelCode> get_template_model_code(template_id, lang, opts)
 
-Get the JSON Schema of a template's submission data
+Generate typed code for a template's submission data
 
-Returns the JSON Schema that a submission's `data` must match. Use it to check data before you create submissions, or to build a form for the template's fields. 
+Generates types for a template's submission data in TypeScript, JavaScript, Ruby, Python, PHP, Java, C#, Elixir or Go, so your app catches mistakes before it calls the API. `root_type_name` is the type of the whole `data` object, and `just_types=true` leaves out the code that converts JSON to and from the types. Java returns every class in `code`, each under a `// ClassName.java` comment. A template with no named fields returns 422. 
 
 ### Examples
 
@@ -1940,34 +2179,36 @@ end
 
 api_instance = DocSpring::Client.new
 template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
+lang = DocSpring::ModelCodeLanguage::TYPESCRIPT # ModelCodeLanguage | The language to generate the code in.
 opts = {
-  version: 'draft' # String | The template version: 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), the version a submission uses by default.
+  version: 'draft', # String | The template version: 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), the version a submission uses by default.
+  just_types: true # Boolean | Return only the types (interfaces, classes or structs), without the code that converts JSON to and from them. Default false. JavaScript has no types and PHP no types-only code, so theirs is the same either way.
 }
 
 begin
-  # Get the JSON Schema of a template's submission data
-  result = api_instance.get_template_schema(template_id, opts)
+  # Generate typed code for a template's submission data
+  result = api_instance.get_template_model_code(template_id, lang, opts)
   p result
 rescue DocSpring::ApiError => e
-  puts "Error when calling Client->get_template_schema: #{e}"
+  puts "Error when calling Client->get_template_model_code: #{e}"
 end
 ```
 
-#### Using the get_template_schema_with_http_info variant
+#### Using the get_template_model_code_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Hash&lt;String, Object&gt;, Integer, Hash)> get_template_schema_with_http_info(template_id, opts)
+> <Array(<TemplateModelCode>, Integer, Hash)> get_template_model_code_with_http_info(template_id, lang, opts)
 
 ```ruby
 begin
-  # Get the JSON Schema of a template's submission data
-  data, status_code, headers = api_instance.get_template_schema_with_http_info(template_id, opts)
+  # Generate typed code for a template's submission data
+  data, status_code, headers = api_instance.get_template_model_code_with_http_info(template_id, lang, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Hash&lt;String, Object&gt;
+  p data # => <TemplateModelCode>
 rescue DocSpring::ApiError => e
-  puts "Error when calling Client->get_template_schema_with_http_info: #{e}"
+  puts "Error when calling Client->get_template_model_code_with_http_info: #{e}"
 end
 ```
 
@@ -1976,11 +2217,13 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **template_id** | **String** | The template's ID. |  |
+| **lang** | [**ModelCodeLanguage**](.md) | The language to generate the code in. |  |
 | **version** | **String** | The template version: 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), the version a submission uses by default. | [optional] |
+| **just_types** | **Boolean** | Return only the types (interfaces, classes or structs), without the code that converts JSON to and from them. Default false. JavaScript has no types and PHP no types-only code, so theirs is the same either way. | [optional] |
 
 ### Return type
 
-**Hash&lt;String, Object&gt;**
+[**TemplateModelCode**](TemplateModelCode.md)
 
 ### Authorization
 
@@ -1992,13 +2235,13 @@ end
 - **Accept**: application/json
 
 
-## get_webhook
+## get_template_page_images
 
-> <Webhook> get_webhook(webhook_id)
+> <TemplatePageImages> get_template_page_images(template_id, opts)
 
-Get a webhook
+Get images of a template's pages
 
-Returns a webhook.
+Returns a JPEG image of each page of a PDF template's PDF, with temporary links to download them: the draft's PDF, or a published version's. Use them to see the pages that fields are placed on. 
 
 ### Examples
 
@@ -2013,32 +2256,35 @@ DocSpring.configure do |config|
 end
 
 api_instance = DocSpring::Client.new
-webhook_id = 'webhook_id_example' # String | The webhook's ID.
+template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
+opts = {
+  version: 'latest' # String | A published version (`1.2.0`, or `1` for the latest 1.x.x), `latest` or `draft`. Default `draft`.
+}
 
 begin
-  # Get a webhook
-  result = api_instance.get_webhook(webhook_id)
+  # Get images of a template's pages
+  result = api_instance.get_template_page_images(template_id, opts)
   p result
 rescue DocSpring::ApiError => e
-  puts "Error when calling Client->get_webhook: #{e}"
+  puts "Error when calling Client->get_template_page_images: #{e}"
 end
 ```
 
-#### Using the get_webhook_with_http_info variant
+#### Using the get_template_page_images_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<Webhook>, Integer, Hash)> get_webhook_with_http_info(webhook_id)
+> <Array(<TemplatePageImages>, Integer, Hash)> get_template_page_images_with_http_info(template_id, opts)
 
 ```ruby
 begin
-  # Get a webhook
-  data, status_code, headers = api_instance.get_webhook_with_http_info(webhook_id)
+  # Get images of a template's pages
+  data, status_code, headers = api_instance.get_template_page_images_with_http_info(template_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <Webhook>
+  p data # => <TemplatePageImages>
 rescue DocSpring::ApiError => e
-  puts "Error when calling Client->get_webhook_with_http_info: #{e}"
+  puts "Error when calling Client->get_template_page_images_with_http_info: #{e}"
 end
 ```
 
@@ -2046,11 +2292,12 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **webhook_id** | **String** | The webhook's ID. |  |
+| **template_id** | **String** | The template's ID. |  |
+| **version** | **String** | A published version (`1.2.0`, or `1` for the latest 1.x.x), `latest` or `draft`. Default `draft`. | [optional] |
 
 ### Return type
 
-[**Webhook**](Webhook.md)
+[**TemplatePageImages**](TemplatePageImages.md)
 
 ### Authorization
 
@@ -2062,13 +2309,13 @@ end
 - **Accept**: application/json
 
 
-## list_combined_pdfs
+## get_template_preview
 
-> <CombinedPdfList> list_combined_pdfs(opts)
+> <TemplatePreview> get_template_preview(template_id, preview_id)
 
-List combined PDFs
+Get a template preview
 
-Returns the combined PDFs in your account, newest first, one page at a time.
+Returns a preview made with POST /templates/{template_id}/previews. Once it's `processed`, `pages` has a PNG image of each page with a temporary link to download it: a preview has no PDF. Previews are deleted an hour after they're created. 
 
 ### Examples
 
@@ -2083,13 +2330,229 @@ DocSpring.configure do |config|
 end
 
 api_instance = DocSpring::Client.new
-opts = {
-  limit: 56, # Integer | How many items to return (1-100, default 50).
-  cursor: 'cursor_example' # String | The previous page's `next_cursor`, to get the next page. It's the ID of that page's last item, so get the next page before you delete or change the items on this one.
-}
+template_id = 'tpl_1234567890abcdef02' # String | The template's ID.
+preview_id = 'tpv_1234567890abcdef0123' # String | The preview's ID.
 
 begin
-  # List combined PDFs
+  # Get a template preview
+  result = api_instance.get_template_preview(template_id, preview_id)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->get_template_preview: #{e}"
+end
+```
+
+#### Using the get_template_preview_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplatePreview>, Integer, Hash)> get_template_preview_with_http_info(template_id, preview_id)
+
+```ruby
+begin
+  # Get a template preview
+  data, status_code, headers = api_instance.get_template_preview_with_http_info(template_id, preview_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplatePreview>
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->get_template_preview_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **template_id** | **String** | The template's ID. |  |
+| **preview_id** | **String** | The preview's ID. |  |
+
+### Return type
+
+[**TemplatePreview**](TemplatePreview.md)
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_template_schema
+
+> Hash&lt;String, Object&gt; get_template_schema(template_id, opts)
+
+Get the JSON Schema of a template's submission data
+
+Returns the JSON Schema that a submission's `data` must match. Use it to check data before you create submissions, or to build a form for the template's fields. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
+opts = {
+  version: 'draft' # String | The template version: 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), the version a submission uses by default.
+}
+
+begin
+  # Get the JSON Schema of a template's submission data
+  result = api_instance.get_template_schema(template_id, opts)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->get_template_schema: #{e}"
+end
+```
+
+#### Using the get_template_schema_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(Hash&lt;String, Object&gt;, Integer, Hash)> get_template_schema_with_http_info(template_id, opts)
+
+```ruby
+begin
+  # Get the JSON Schema of a template's submission data
+  data, status_code, headers = api_instance.get_template_schema_with_http_info(template_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => Hash&lt;String, Object&gt;
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->get_template_schema_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **template_id** | **String** | The template's ID. |  |
+| **version** | **String** | The template version: 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), the version a submission uses by default. | [optional] |
+
+### Return type
+
+**Hash&lt;String, Object&gt;**
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_webhook
+
+> <Webhook> get_webhook(webhook_id)
+
+Get a webhook
+
+Returns a webhook.
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+webhook_id = 'webhook_id_example' # String | The webhook's ID.
+
+begin
+  # Get a webhook
+  result = api_instance.get_webhook(webhook_id)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->get_webhook: #{e}"
+end
+```
+
+#### Using the get_webhook_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<Webhook>, Integer, Hash)> get_webhook_with_http_info(webhook_id)
+
+```ruby
+begin
+  # Get a webhook
+  data, status_code, headers = api_instance.get_webhook_with_http_info(webhook_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <Webhook>
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->get_webhook_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **webhook_id** | **String** | The webhook's ID. |  |
+
+### Return type
+
+[**Webhook**](Webhook.md)
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_combined_pdfs
+
+> <CombinedPdfList> list_combined_pdfs(opts)
+
+List combined PDFs
+
+Returns the combined PDFs in your account, newest first, one page at a time.
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+opts = {
+  limit: 56, # Integer | How many items to return (1-100, default 50).
+  cursor: 'cursor_example' # String | The previous page's `next_cursor`, to get the next page. It's the ID of that page's last item, so get the next page before you delete or change the items on this one.
+}
+
+begin
+  # List combined PDFs
   result = api_instance.list_combined_pdfs(opts)
   p result
 rescue DocSpring::ApiError => e
@@ -2292,7 +2755,7 @@ end
 
 List submissions
 
-Returns the submissions in your account, newest first, one page at a time. Lists leave out each submission's `data` unless you pass `include_data=true`. 
+Returns the submissions in your account, newest first, one page at a time. Each one is a summary: its `data` is null unless you pass `include_data=true`, and its `files` are empty unless you pass `include_files=true`. Get a submission by its ID for its signature requests, uploads and page images. 
 
 ### Examples
 
@@ -2314,7 +2777,9 @@ opts = {
   created_before: Time.parse('2018-10-20T09:00:00Z'), # Time | Only list submissions created before this time.
   include_data: true, # Boolean | Include each submission's `data` (null without it).
   limit: 56, # Integer | How many items to return (1-100, default 50).
-  cursor: 'cursor_example' # String | The previous page's `next_cursor`, to get the next page. It's the ID of that page's last item, so get the next page before you delete or change the items on this one.
+  cursor: 'cursor_example', # String | The previous page's `next_cursor`, to get the next page. It's the ID of that page's last item, so get the next page before you delete or change the items on this one.
+  state: DocSpring::SubmissionState::PENDING, # SubmissionState | Only list submissions in this state (one state per request). The ones that failed are `invalid_data`, `error`, `syntax_error`, `image_download_failed` and `image_processing_failed`, and one still `pending` an hour after it was created is stuck.
+  include_files: true # Boolean | Include each submission's generated files and their download links (`files`, empty without it), without the page images' links.
 }
 
 begin
@@ -2355,6 +2820,8 @@ end
 | **include_data** | **Boolean** | Include each submission's `data` (null without it). | [optional] |
 | **limit** | **Integer** | How many items to return (1-100, default 50). | [optional][default to 50] |
 | **cursor** | **String** | The previous page's `next_cursor`, to get the next page. It's the ID of that page's last item, so get the next page before you delete or change the items on this one. | [optional] |
+| **state** | [**SubmissionState**](.md) | Only list submissions in this state (one state per request). The ones that failed are `invalid_data`, `error`, `syntax_error`, `image_download_failed` and `image_processing_failed`, and one still `pending` an hour after it was created is stuck. | [optional] |
+| **include_files** | **Boolean** | Include each submission's generated files and their download links (`files`, empty without it), without the page images' links. | [optional] |
 
 ### Return type
 
@@ -2370,6 +2837,80 @@ end
 - **Accept**: application/json
 
 
+## list_template_fields
+
+> <TemplateFields> list_template_fields(template_id, opts)
+
+List a template's fields
+
+Returns a template's fields with all of their settings, page by page: the draft's fields, or a published version's. A PDF template's fields are placed on its pages: GET /templates/{template_id}/page_images has images of the pages. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
+opts = {
+  version: 'latest' # String | A published version (`1.2.0`, or `1` for the latest 1.x.x), `latest` or `draft`. Default `draft`.
+}
+
+begin
+  # List a template's fields
+  result = api_instance.list_template_fields(template_id, opts)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->list_template_fields: #{e}"
+end
+```
+
+#### Using the list_template_fields_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplateFields>, Integer, Hash)> list_template_fields_with_http_info(template_id, opts)
+
+```ruby
+begin
+  # List a template's fields
+  data, status_code, headers = api_instance.list_template_fields_with_http_info(template_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplateFields>
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->list_template_fields_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **template_id** | **String** | The template's ID. |  |
+| **version** | **String** | A published version (`1.2.0`, or `1` for the latest 1.x.x), `latest` or `draft`. Default `draft`. | [optional] |
+
+### Return type
+
+[**TemplateFields**](TemplateFields.md)
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_template_submissions
 
 > <SubmissionList> list_template_submissions(template_id, opts)
@@ -2398,7 +2939,9 @@ opts = {
   created_before: Time.parse('2013-10-20T19:20:30+01:00'), # Time | Only list submissions created before this time.
   include_data: true, # Boolean | Include each submission's `data` (null without it).
   limit: 56, # Integer | How many items to return (1-100, default 50).
-  cursor: 'cursor_example' # String | The previous page's `next_cursor`, to get the next page. It's the ID of that page's last item, so get the next page before you delete or change the items on this one.
+  cursor: 'cursor_example', # String | The previous page's `next_cursor`, to get the next page. It's the ID of that page's last item, so get the next page before you delete or change the items on this one.
+  state: DocSpring::SubmissionState::PENDING, # SubmissionState | Only list submissions in this state (one state per request). The ones that failed are `invalid_data`, `error`, `syntax_error`, `image_download_failed` and `image_processing_failed`, and one still `pending` an hour after it was created is stuck.
+  include_files: true # Boolean | Include each submission's generated files and their download links (`files`, empty without it), without the page images' links.
 }
 
 begin
@@ -2439,6 +2982,8 @@ end
 | **include_data** | **Boolean** | Include each submission's `data` (null without it). | [optional] |
 | **limit** | **Integer** | How many items to return (1-100, default 50). | [optional][default to 50] |
 | **cursor** | **String** | The previous page's `next_cursor`, to get the next page. It's the ID of that page's last item, so get the next page before you delete or change the items on this one. | [optional] |
+| **state** | [**SubmissionState**](.md) | Only list submissions in this state (one state per request). The ones that failed are `invalid_data`, `error`, `syntax_error`, `image_download_failed` and `image_processing_failed`, and one still `pending` an hour after it was created is stuck. | [optional] |
+| **include_files** | **Boolean** | Include each submission's generated files and their download links (`files`, empty without it), without the page images' links. | [optional] |
 
 ### Return type
 
@@ -2460,7 +3005,7 @@ end
 
 List templates
 
-Returns the templates in your account (their drafts), newest first, one page at a time. Get a template by its ID for its HTML, defaults and published versions. 
+Returns the templates in your account (their drafts), newest first, one page at a time. Each one is a summary: get a template by its ID for its settings, its PDF in full, its HTML, defaults and published versions. 
 
 ### Examples
 
@@ -2766,7 +3311,7 @@ end
 
 Publish a template version
 
-Publishes the template's draft as a new version that doesn't change. `version_type` says which part of the latest version number goes up. 
+Publishes the template's draft as a new version that doesn't change. `version_type` says which part of the latest version number goes up. While the template's PDF is downloading or being processed, or DocSpring is setting up its fields, it returns a 409 that says so. 
 
 ### Examples
 
@@ -2832,6 +3377,78 @@ end
 - **Accept**: application/json
 
 
+## remove_template_fields
+
+> <TemplateFields> remove_template_fields(template_id, body)
+
+Remove fields from a template
+
+Removes fields from a template's draft and returns the fields that are left. Conditional logic that used only the removed fields is removed too. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
+body = DocSpring::RemoveTemplateFieldsRequest.new({field_ids: [37]}) # RemoveTemplateFieldsRequest | The fields to remove from the template's draft.
+
+begin
+  # Remove fields from a template
+  result = api_instance.remove_template_fields(template_id, body)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->remove_template_fields: #{e}"
+end
+```
+
+#### Using the remove_template_fields_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplateFields>, Integer, Hash)> remove_template_fields_with_http_info(template_id, body)
+
+```ruby
+begin
+  # Remove fields from a template
+  data, status_code, headers = api_instance.remove_template_fields_with_http_info(template_id, body)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplateFields>
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->remove_template_fields_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **template_id** | **String** | The template's ID. |  |
+| **body** | [**RemoveTemplateFieldsRequest**](RemoveTemplateFieldsRequest.md) | The fields to remove from the template's draft. |  |
+
+### Return type
+
+[**TemplateFields**](TemplateFields.md)
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## rename_folder
 
 > <Folder> rename_folder(folder_id, body)
@@ -2904,6 +3521,78 @@ end
 - **Accept**: application/json
 
 
+## reorder_template_fields
+
+> <TemplateFields> reorder_template_fields(template_id, body)
+
+Reorder a template's fields
+
+Changes the order of the fields in a template's draft and returns them in their new order. Send every field's ID: each field stays on its page, and a page's fields are printed in this order, so a later field prints over an earlier one where they overlap. Their values are in this order in the template's data schema and forms. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
+body = DocSpring::ReorderTemplateFieldsRequest.new({field_ids: [37]}) # ReorderTemplateFieldsRequest | The new order of the fields in the template's draft.
+
+begin
+  # Reorder a template's fields
+  result = api_instance.reorder_template_fields(template_id, body)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->reorder_template_fields: #{e}"
+end
+```
+
+#### Using the reorder_template_fields_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplateFields>, Integer, Hash)> reorder_template_fields_with_http_info(template_id, body)
+
+```ruby
+begin
+  # Reorder a template's fields
+  data, status_code, headers = api_instance.reorder_template_fields_with_http_info(template_id, body)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplateFields>
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->reorder_template_fields_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **template_id** | **String** | The template's ID. |  |
+| **body** | [**ReorderTemplateFieldsRequest**](ReorderTemplateFieldsRequest.md) | The new order of the fields in the template's draft. |  |
+
+### Return type
+
+[**TemplateFields**](TemplateFields.md)
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## restore_template_version
 
 > <Template> restore_template_version(template_id, body)
@@ -3121,7 +3810,7 @@ end
 
 Update a template
 
-Changes a template's draft. Properties left out keep their values. `defaults` and `html_engine_options` replace the whole object. Setting `parent_folder_id` moves the template and all of its published versions. 
+Changes a template's draft. Properties left out keep their values. `defaults` and `html_engine_options` replace the whole object, and `field_groups` changes only the groups it lists. Setting `parent_folder_id` moves the template and all of its published versions. 
 
 ### Examples
 
@@ -3193,7 +3882,7 @@ end
 
 Replace a template's PDF
 
-Replaces a PDF template's PDF with one you uploaded with the presigned upload (GET /uploads/presign). The fields stay where they are, unless `reimport_fields` replaces them with the new PDF's fillable fields. To send the PDF with the request instead, use PUT /templates/{template_id}/document/upload. 
+Replaces a PDF template's PDF with one you uploaded with the presigned upload (GET /uploads/presign) (`cache_id`), a link to download it from (`document_url`), or the file in base64 (`document_base64`). The fields stay where they are, unless `reimport_fields` replaces them with the new PDF's fillable fields. To send the PDF as `multipart/form-data` instead, use PUT /templates/{template_id}/document/upload. 
 
 ### Examples
 
@@ -3209,9 +3898,9 @@ end
 
 api_instance = DocSpring::Client.new
 template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
-body = DocSpring::UpdateTemplateDocumentRequest.new({cache_id: 'cache_id_example'}) # UpdateTemplateDocumentRequest | The new PDF.
+body = DocSpring::UpdateTemplateDocumentRequest.new # UpdateTemplateDocumentRequest | The new PDF, as one of `cache_id`, `document_url` and `document_base64`.
 opts = {
-  wait: true # Boolean | Wait until the PDF has been processed before responding. Default true on sync.api hosts.
+  wait: true # Boolean | Wait until the PDF has been processed, and a `document_url` downloaded, before responding. Default true on sync.api hosts.
 }
 
 begin
@@ -3246,8 +3935,8 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **template_id** | **String** | The template's ID. |  |
-| **body** | [**UpdateTemplateDocumentRequest**](UpdateTemplateDocumentRequest.md) | The new PDF. |  |
-| **wait** | **Boolean** | Wait until the PDF has been processed before responding. Default true on sync.api hosts. | [optional] |
+| **body** | [**UpdateTemplateDocumentRequest**](UpdateTemplateDocumentRequest.md) | The new PDF, as one of `cache_id`, `document_url` and `document_base64`. |  |
+| **wait** | **Boolean** | Wait until the PDF has been processed, and a `document_url` downloaded, before responding. Default true on sync.api hosts. | [optional] |
 
 ### Return type
 
@@ -3263,6 +3952,78 @@ end
 - **Accept**: application/json
 
 
+## update_template_fields
+
+> <TemplateFields> update_template_fields(template_id, body)
+
+Update a template's fields
+
+Changes fields of a template's draft and returns all of its fields. Settings left out keep their values. A shared setting (`type`, `required`, `default`, ...) changes for every field with the same name. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
+body = DocSpring::UpdateTemplateFieldsRequest.new({fields: [DocSpring::FieldInput.new]}) # UpdateTemplateFieldsRequest | The fields to change in the template's draft.
+
+begin
+  # Update a template's fields
+  result = api_instance.update_template_fields(template_id, body)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->update_template_fields: #{e}"
+end
+```
+
+#### Using the update_template_fields_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplateFields>, Integer, Hash)> update_template_fields_with_http_info(template_id, body)
+
+```ruby
+begin
+  # Update a template's fields
+  data, status_code, headers = api_instance.update_template_fields_with_http_info(template_id, body)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplateFields>
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->update_template_fields_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **template_id** | **String** | The template's ID. |  |
+| **body** | [**UpdateTemplateFieldsRequest**](UpdateTemplateFieldsRequest.md) | The fields to change in the template's draft. |  |
+
+### Return type
+
+[**TemplateFields**](TemplateFields.md)
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## update_webhook
 
 > <Webhook> update_webhook(webhook_id, body)
@@ -3358,7 +4119,7 @@ end
 api_instance = DocSpring::Client.new
 document = File.new('/path/to/some/file') # File | The PDF.
 opts = {
-  wait: true, # Boolean | Wait until the PDF has been processed before responding. Default true on sync.api hosts.
+  wait: true, # Boolean | Wait until the PDF has been processed, and a `document_url` downloaded, before responding. Default true on sync.api hosts.
   name: 'name_example', # String | The template's name.
   description: 'description_example', # String | The template's description.
   parent_folder_id: 'parent_folder_id_example', # String | The folder to put the template in. Left out, it's created at the root.
@@ -3401,7 +4162,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **document** | **File** | The PDF. |  |
-| **wait** | **Boolean** | Wait until the PDF has been processed before responding. Default true on sync.api hosts. | [optional] |
+| **wait** | **Boolean** | Wait until the PDF has been processed, and a `document_url` downloaded, before responding. Default true on sync.api hosts. | [optional] |
 | **name** | **String** | The template's name. | [optional] |
 | **description** | **String** | The template's description. | [optional] |
 | **parent_folder_id** | **String** | The folder to put the template in. Left out, it's created at the root. | [optional] |
@@ -3449,7 +4210,7 @@ api_instance = DocSpring::Client.new
 template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
 document = File.new('/path/to/some/file') # File | The new PDF.
 opts = {
-  wait: true, # Boolean | Wait until the PDF has been processed before responding. Default true on sync.api hosts.
+  wait: true, # Boolean | Wait until the PDF has been processed, and a `document_url` downloaded, before responding. Default true on sync.api hosts.
   reimport_fields: true # Boolean | Replace all of the template's fields with the fillable fields in the new PDF, once DocSpring has processed it (`document.field_reimport_state`). As on a first upload, the default typeface, font size, bold and color are taken from the PDF's fields; the template's other settings are kept. If the PDF has no fillable fields, the template keeps its fields. A locked template can't re-import its fields.
 }
 
@@ -3486,7 +4247,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **template_id** | **String** | The template's ID. |  |
 | **document** | **File** | The new PDF. |  |
-| **wait** | **Boolean** | Wait until the PDF has been processed before responding. Default true on sync.api hosts. | [optional] |
+| **wait** | **Boolean** | Wait until the PDF has been processed, and a `document_url` downloaded, before responding. Default true on sync.api hosts. | [optional] |
 | **reimport_fields** | **Boolean** | Replace all of the template's fields with the fillable fields in the new PDF, once DocSpring has processed it (`document.field_reimport_state`). As on a first upload, the default typeface, font size, bold and color are taken from the PDF's fields; the template's other settings are kept. If the PDF has no fillable fields, the template keeps its fields. A locked template can't re-import its fields. | [optional] |
 
 ### Return type
@@ -3502,3 +4263,79 @@ end
 - **Content-Type**: multipart/form-data
 - **Accept**: application/json
 
+
+## validate_submission
+
+> <SubmissionValidation> validate_submission(template_id, body, opts)
+
+Check a submission without creating it
+
+Checks a submission as creating it would (its data against the template's fields, its settings and signature requests) without saving it, generating anything or using credits. It doesn't check your account's credits. The response says whether the submission is valid, and if not, has the error that creating it would return. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'docspring'
+# setup authorization
+DocSpring.configure do |config|
+  # Configure HTTP basic authorization: api_token_basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = DocSpring::Client.new
+template_id = 'tpl_1234567890abcdef01' # String | The template's ID.
+body = DocSpring::ValidateSubmissionRequest.new # ValidateSubmissionRequest | The submission's data and settings.
+opts = {
+  version: 'latest' # String | The template 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).
+}
+
+begin
+  # Check a submission without creating it
+  result = api_instance.validate_submission(template_id, body, opts)
+  p result
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->validate_submission: #{e}"
+end
+```
+
+#### Using the validate_submission_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SubmissionValidation>, Integer, Hash)> validate_submission_with_http_info(template_id, body, opts)
+
+```ruby
+begin
+  # Check a submission without creating it
+  data, status_code, headers = api_instance.validate_submission_with_http_info(template_id, body, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SubmissionValidation>
+rescue DocSpring::ApiError => e
+  puts "Error when calling Client->validate_submission_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **template_id** | **String** | The template's ID. |  |
+| **body** | [**ValidateSubmissionRequest**](ValidateSubmissionRequest.md) | The submission's data and settings. |  |
+| **version** | **String** | The template 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] |
+
+### Return type
+
+[**SubmissionValidation**](SubmissionValidation.md)
+
+### Authorization
+
+[api_token_basic](../README.md#api_token_basic)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+