Update to version 4.1.0 on 2026-10-27

- New: list_template_fields, add_template_fields, update_template_fields, remove_template_fields and
  reorder_template_fields read and edit a template's fields (`Field`), with all their settings and their own conditional
  logic (`dependencies`). A field's `y` is measured from the top of its page.
- New: a template's `predefined_fields` (`PredefinedField`) and `predefined_fields_sample_data`, the field names that
  people using the embedded template editor choose from. get_template returns them, and create_template and
  update_template set them.
- New: a template's `field_groups` (`FieldGroup`), the groups that its fields' names make, with their titles and the
  settings of lists (`min_items`, `max_items`, `allow_additional_items`). get_template returns them, and update_template
  changes them.
- New: get_template_page_images returns an image of each page of a PDF template (`TemplatePageImages`), to see where
  fields go.
- New: get_template_diff says what changed in a template's draft since its latest published version, or in a published
  version since the one before it (`TemplateDiff`).
- New: validate_submission checks a submission's data and settings as create_submission does, without creating the
  submission or using credits (`SubmissionValidation`). It doesn't check your account's credits.
- New: the `png` output format, an image of each page of a submission's PDF (`files.png.pages`). Add it to
  `output_formats` in create_submission or create_submission_batch (it adds `pdf`), or to a processed submission with
  generate_submission_files.
- create_template and update_template_document take a `document_url` (DocSpring downloads it) or a `document_base64`
  instead of a `cache_id`. While the URL downloads, the template's `document.state` is `downloading`; if it can't be
  downloaded, it's `download_failed` and `document.error_message` says why.

Author: ndbroadbent

.openapi-generator/FILES

@@ -5,6 +5,7 @@ README.md
 api/openapi.yaml
 build.gradle
 build.sbt
+docs/AddTemplateFieldsRequest.md
 docs/AiFieldNamingLanguage.md
 docs/AuthenticationCheck.md
 docs/BarcodeSymbology.md
@@ -37,12 +38,19 @@ docs/ErrorDetail.md
 docs/ErrorInfo.md
 docs/ErrorResponse.md
 docs/ExpirationInterval.md
+docs/Field.md
 docs/FieldComparisonCondition.md
 docs/FieldComparisonOperator.md
+docs/FieldDependency.md
+docs/FieldDependencyInput.md
 docs/FieldDisplayType.md
 docs/FieldEqualsCondition.md
 docs/FieldEqualsOperator.md
+docs/FieldGroup.md
+docs/FieldGroupInput.md
+docs/FieldGroupType.md
 docs/FieldInCondition.md
+docs/FieldInput.md
 docs/FieldOverride.md
 docs/FieldPresenceCondition.md
 docs/FieldPresenceOperator.md
@@ -51,8 +59,11 @@ docs/FieldReimportState.md
 docs/FieldSetupLogic.md
 docs/FieldSetupNaming.md
 docs/FieldSetupSource.md
+docs/FieldType.md
 docs/Folder.md
 docs/FolderList.md
+docs/GenerateFilesFormat.md
+docs/GenerateSubmissionFilesRequest.md
 docs/GeneratedFile.md
 docs/GeneratedFileState.md
 docs/HtmlEngineOptions.md
@@ -63,9 +74,16 @@ docs/ModelCodeLanguage.md
 docs/MoveFolderRequest.md
 docs/MoveTemplateRequest.md
 docs/NumberConditionType.md
+docs/OutputFormat.md
 docs/PageFormat.md
+docs/PageImage.md
+docs/PageImages.md
+docs/PredefinedField.md
+docs/PredefinedFieldInput.md
 docs/PublishTemplateVersionRequest.md
+docs/RemoveTemplateFieldsRequest.md
 docs/RenameFolderRequest.md
+docs/ReorderTemplateFieldsRequest.md
 docs/RestoreTemplateVersionRequest.md
 docs/ShapeType.md
 docs/SignatureRequest.md
@@ -91,13 +109,18 @@ docs/SubmissionList.md
 docs/SubmissionSource.md
 docs/SubmissionSourcePdf.md
 docs/SubmissionState.md
+docs/SubmissionValidation.md
 docs/Template.md
 docs/TemplateActor.md
 docs/TemplateActorType.md
 docs/TemplateDefaults.md
 docs/TemplateDefaultsInput.md
+docs/TemplateDiff.md
+docs/TemplateDiffSummary.md
 docs/TemplateDocument.md
 docs/TemplateDocumentState.md
+docs/TemplateFieldChange.md
+docs/TemplateFieldChanges.md
 docs/TemplateFieldDependency.md
 docs/TemplateFieldDependencyAction.md
 docs/TemplateFieldDependencyCondition.md
@@ -106,12 +129,15 @@ docs/TemplateFieldDependencyInput.md
 docs/TemplateFieldDependencyMatch.md
 docs/TemplateFieldDependencyOperator.md
 docs/TemplateFieldLogicStatus.md
+docs/TemplateFieldMove.md
+docs/TemplateFields.md
 docs/TemplateFormMode.md
 docs/TemplateModelCode.md
 docs/TemplatePageAiError.md
 docs/TemplatePageAiNamingStatus.md
 docs/TemplatePageFieldsStatus.md
 docs/TemplatePageImageStatus.md
+docs/TemplatePageImages.md
 docs/TemplatePageProcessingStatus.md
 docs/TemplateSourcePdf.md
 docs/TemplateSummary.md
@@ -125,11 +151,13 @@ docs/TextVerticalAlignment.md
 docs/Typeface.md
 docs/UpdateSignatureRequestRequest.md
 docs/UpdateTemplateDocumentRequest.md
+docs/UpdateTemplateFieldsRequest.md
 docs/UpdateTemplateRequest.md
 docs/UpdateWebhookRequest.md
 docs/UploadMethod.md
 docs/UploadPresign.md
 docs/UrlSourcePdf.md
+docs/ValidateSubmissionRequest.md
 docs/Webhook.md
 docs/WebhookEventType.md
 docs/WebhookList.md
@@ -144,6 +172,7 @@ pom.xml
 settings.gradle
 src/main/AndroidManifest.xml
 src/main/java/com/docspring/AbstractOpenApiSchema.java
+src/main/java/com/docspring/AddTemplateFieldsRequest.java
 src/main/java/com/docspring/AiFieldNamingLanguage.java
 src/main/java/com/docspring/ApiClient.java
 src/main/java/com/docspring/ApiException.java
@@ -180,12 +209,19 @@ src/main/java/com/docspring/ErrorDetail.java
 src/main/java/com/docspring/ErrorInfo.java
 src/main/java/com/docspring/ErrorResponse.java
 src/main/java/com/docspring/ExpirationInterval.java
+src/main/java/com/docspring/Field.java
 src/main/java/com/docspring/FieldComparisonCondition.java
 src/main/java/com/docspring/FieldComparisonOperator.java
+src/main/java/com/docspring/FieldDependency.java
+src/main/java/com/docspring/FieldDependencyInput.java
 src/main/java/com/docspring/FieldDisplayType.java
 src/main/java/com/docspring/FieldEqualsCondition.java
 src/main/java/com/docspring/FieldEqualsOperator.java
+src/main/java/com/docspring/FieldGroup.java
+src/main/java/com/docspring/FieldGroupInput.java
+src/main/java/com/docspring/FieldGroupType.java
 src/main/java/com/docspring/FieldInCondition.java
+src/main/java/com/docspring/FieldInput.java
 src/main/java/com/docspring/FieldOverride.java
 src/main/java/com/docspring/FieldPresenceCondition.java
 src/main/java/com/docspring/FieldPresenceOperator.java
@@ -194,8 +230,11 @@ src/main/java/com/docspring/FieldReimportState.java
 src/main/java/com/docspring/FieldSetupLogic.java
 src/main/java/com/docspring/FieldSetupNaming.java
 src/main/java/com/docspring/FieldSetupSource.java
+src/main/java/com/docspring/FieldType.java
 src/main/java/com/docspring/Folder.java
 src/main/java/com/docspring/FolderList.java
+src/main/java/com/docspring/GenerateFilesFormat.java
+src/main/java/com/docspring/GenerateSubmissionFilesRequest.java
 src/main/java/com/docspring/GeneratedFile.java
 src/main/java/com/docspring/GeneratedFileState.java
 src/main/java/com/docspring/HtmlEngineOptions.java
@@ -208,13 +247,20 @@ src/main/java/com/docspring/ModelCodeLanguage.java
 src/main/java/com/docspring/MoveFolderRequest.java
 src/main/java/com/docspring/MoveTemplateRequest.java
 src/main/java/com/docspring/NumberConditionType.java
+src/main/java/com/docspring/OutputFormat.java
 src/main/java/com/docspring/PageFormat.java
+src/main/java/com/docspring/PageImage.java
+src/main/java/com/docspring/PageImages.java
 src/main/java/com/docspring/Pair.java
+src/main/java/com/docspring/PredefinedField.java
+src/main/java/com/docspring/PredefinedFieldInput.java
 src/main/java/com/docspring/PublishTemplateVersionRequest.java
 src/main/java/com/docspring/RFC3339DateFormat.java
 src/main/java/com/docspring/RFC3339InstantDeserializer.java
 src/main/java/com/docspring/RFC3339JavaTimeModule.java
+src/main/java/com/docspring/RemoveTemplateFieldsRequest.java
 src/main/java/com/docspring/RenameFolderRequest.java
+src/main/java/com/docspring/ReorderTemplateFieldsRequest.java
 src/main/java/com/docspring/RestoreTemplateVersionRequest.java
 src/main/java/com/docspring/ServerConfiguration.java
 src/main/java/com/docspring/ServerVariable.java
@@ -243,13 +289,18 @@ src/main/java/com/docspring/SubmissionList.java
 src/main/java/com/docspring/SubmissionSource.java
 src/main/java/com/docspring/SubmissionSourcePdf.java
 src/main/java/com/docspring/SubmissionState.java
+src/main/java/com/docspring/SubmissionValidation.java
 src/main/java/com/docspring/Template.java
 src/main/java/com/docspring/TemplateActor.java
 src/main/java/com/docspring/TemplateActorType.java
 src/main/java/com/docspring/TemplateDefaults.java
 src/main/java/com/docspring/TemplateDefaultsInput.java
+src/main/java/com/docspring/TemplateDiff.java
+src/main/java/com/docspring/TemplateDiffSummary.java
 src/main/java/com/docspring/TemplateDocument.java
 src/main/java/com/docspring/TemplateDocumentState.java
+src/main/java/com/docspring/TemplateFieldChange.java
+src/main/java/com/docspring/TemplateFieldChanges.java
 src/main/java/com/docspring/TemplateFieldDependency.java
 src/main/java/com/docspring/TemplateFieldDependencyAction.java
 src/main/java/com/docspring/TemplateFieldDependencyCondition.java
@@ -258,12 +309,15 @@ src/main/java/com/docspring/TemplateFieldDependencyInput.java
 src/main/java/com/docspring/TemplateFieldDependencyMatch.java
 src/main/java/com/docspring/TemplateFieldDependencyOperator.java
 src/main/java/com/docspring/TemplateFieldLogicStatus.java
+src/main/java/com/docspring/TemplateFieldMove.java
+src/main/java/com/docspring/TemplateFields.java
 src/main/java/com/docspring/TemplateFormMode.java
 src/main/java/com/docspring/TemplateModelCode.java
 src/main/java/com/docspring/TemplatePageAiError.java
 src/main/java/com/docspring/TemplatePageAiNamingStatus.java
 src/main/java/com/docspring/TemplatePageFieldsStatus.java
 src/main/java/com/docspring/TemplatePageImageStatus.java
+src/main/java/com/docspring/TemplatePageImages.java
 src/main/java/com/docspring/TemplatePageProcessingStatus.java
 src/main/java/com/docspring/TemplateSourcePdf.java
 src/main/java/com/docspring/TemplateSummary.java
@@ -277,11 +331,13 @@ src/main/java/com/docspring/TextVerticalAlignment.java
 src/main/java/com/docspring/Typeface.java
 src/main/java/com/docspring/UpdateSignatureRequestRequest.java
 src/main/java/com/docspring/UpdateTemplateDocumentRequest.java
+src/main/java/com/docspring/UpdateTemplateFieldsRequest.java
 src/main/java/com/docspring/UpdateTemplateRequest.java
 src/main/java/com/docspring/UpdateWebhookRequest.java
 src/main/java/com/docspring/UploadMethod.java
 src/main/java/com/docspring/UploadPresign.java
 src/main/java/com/docspring/UrlSourcePdf.java
+src/main/java/com/docspring/ValidateSubmissionRequest.java
 src/main/java/com/docspring/Webhook.java
 src/main/java/com/docspring/WebhookEventType.java
 src/main/java/com/docspring/WebhookList.java
@@ -290,6 +346,7 @@ src/main/java/com/docspring/auth/ApiKeyAuth.java
 src/main/java/com/docspring/auth/Authentication.java
 src/main/java/com/docspring/auth/HttpBasicAuth.java
 src/main/java/com/docspring/auth/HttpBearerAuth.java
+src/test/java/com/docspring/AddTemplateFieldsRequestTest.java
 src/test/java/com/docspring/AiFieldNamingLanguageTest.java
 src/test/java/com/docspring/AuthenticationCheckTest.java
 src/test/java/com/docspring/BarcodeSymbologyTest.java
@@ -324,10 +381,16 @@ src/test/java/com/docspring/ErrorResponseTest.java
 src/test/java/com/docspring/ExpirationIntervalTest.java
 src/test/java/com/docspring/FieldComparisonConditionTest.java
 src/test/java/com/docspring/FieldComparisonOperatorTest.java
+src/test/java/com/docspring/FieldDependencyInputTest.java
+src/test/java/com/docspring/FieldDependencyTest.java
 src/test/java/com/docspring/FieldDisplayTypeTest.java
 src/test/java/com/docspring/FieldEqualsConditionTest.java
 src/test/java/com/docspring/FieldEqualsOperatorTest.java
+src/test/java/com/docspring/FieldGroupInputTest.java
+src/test/java/com/docspring/FieldGroupTest.java
+src/test/java/com/docspring/FieldGroupTypeTest.java
 src/test/java/com/docspring/FieldInConditionTest.java
+src/test/java/com/docspring/FieldInputTest.java
 src/test/java/com/docspring/FieldOverrideTest.java
 src/test/java/com/docspring/FieldPresenceConditionTest.java
 src/test/java/com/docspring/FieldPresenceOperatorTest.java
@@ -336,8 +399,12 @@ src/test/java/com/docspring/FieldReimportStateTest.java
 src/test/java/com/docspring/FieldSetupLogicTest.java
 src/test/java/com/docspring/FieldSetupNamingTest.java
 src/test/java/com/docspring/FieldSetupSourceTest.java
+src/test/java/com/docspring/FieldTest.java
+src/test/java/com/docspring/FieldTypeTest.java
 src/test/java/com/docspring/FolderListTest.java
 src/test/java/com/docspring/FolderTest.java
+src/test/java/com/docspring/GenerateFilesFormatTest.java
+src/test/java/com/docspring/GenerateSubmissionFilesRequestTest.java
 src/test/java/com/docspring/GeneratedFileStateTest.java
 src/test/java/com/docspring/GeneratedFileTest.java
 src/test/java/com/docspring/HtmlEngineOptionsInputTest.java
@@ -348,9 +415,16 @@ src/test/java/com/docspring/ModelCodeLanguageTest.java
 src/test/java/com/docspring/MoveFolderRequestTest.java
 src/test/java/com/docspring/MoveTemplateRequestTest.java
 src/test/java/com/docspring/NumberConditionTypeTest.java
+src/test/java/com/docspring/OutputFormatTest.java
 src/test/java/com/docspring/PageFormatTest.java
+src/test/java/com/docspring/PageImageTest.java
+src/test/java/com/docspring/PageImagesTest.java
+src/test/java/com/docspring/PredefinedFieldInputTest.java
+src/test/java/com/docspring/PredefinedFieldTest.java
 src/test/java/com/docspring/PublishTemplateVersionRequestTest.java
+src/test/java/com/docspring/RemoveTemplateFieldsRequestTest.java
 src/test/java/com/docspring/RenameFolderRequestTest.java
+src/test/java/com/docspring/ReorderTemplateFieldsRequestTest.java
 src/test/java/com/docspring/RestoreTemplateVersionRequestTest.java
 src/test/java/com/docspring/ShapeTypeTest.java
 src/test/java/com/docspring/SignatureRequestAuthSecondFactorTypeTest.java
@@ -376,12 +450,17 @@ src/test/java/com/docspring/SubmissionSourcePdfTest.java
 src/test/java/com/docspring/SubmissionSourceTest.java
 src/test/java/com/docspring/SubmissionStateTest.java
 src/test/java/com/docspring/SubmissionTest.java
+src/test/java/com/docspring/SubmissionValidationTest.java
 src/test/java/com/docspring/TemplateActorTest.java
 src/test/java/com/docspring/TemplateActorTypeTest.java
 src/test/java/com/docspring/TemplateDefaultsInputTest.java
 src/test/java/com/docspring/TemplateDefaultsTest.java
+src/test/java/com/docspring/TemplateDiffSummaryTest.java
+src/test/java/com/docspring/TemplateDiffTest.java
 src/test/java/com/docspring/TemplateDocumentStateTest.java
 src/test/java/com/docspring/TemplateDocumentTest.java
+src/test/java/com/docspring/TemplateFieldChangeTest.java
+src/test/java/com/docspring/TemplateFieldChangesTest.java
 src/test/java/com/docspring/TemplateFieldDependencyActionTest.java
 src/test/java/com/docspring/TemplateFieldDependencyConditionInputTest.java
 src/test/java/com/docspring/TemplateFieldDependencyConditionTest.java
@@ -390,12 +469,15 @@ src/test/java/com/docspring/TemplateFieldDependencyMatchTest.java
 src/test/java/com/docspring/TemplateFieldDependencyOperatorTest.java
 src/test/java/com/docspring/TemplateFieldDependencyTest.java
 src/test/java/com/docspring/TemplateFieldLogicStatusTest.java
+src/test/java/com/docspring/TemplateFieldMoveTest.java
+src/test/java/com/docspring/TemplateFieldsTest.java
 src/test/java/com/docspring/TemplateFormModeTest.java
 src/test/java/com/docspring/TemplateModelCodeTest.java
 src/test/java/com/docspring/TemplatePageAiErrorTest.java
 src/test/java/com/docspring/TemplatePageAiNamingStatusTest.java
 src/test/java/com/docspring/TemplatePageFieldsStatusTest.java
 src/test/java/com/docspring/TemplatePageImageStatusTest.java
+src/test/java/com/docspring/TemplatePageImagesTest.java
 src/test/java/com/docspring/TemplatePageProcessingStatusTest.java
 src/test/java/com/docspring/TemplateSourcePdfTest.java
 src/test/java/com/docspring/TemplateSummaryListTest.java
@@ -410,11 +492,13 @@ src/test/java/com/docspring/TextVerticalAlignmentTest.java
 src/test/java/com/docspring/TypefaceTest.java
 src/test/java/com/docspring/UpdateSignatureRequestRequestTest.java
 src/test/java/com/docspring/UpdateTemplateDocumentRequestTest.java
+src/test/java/com/docspring/UpdateTemplateFieldsRequestTest.java
 src/test/java/com/docspring/UpdateTemplateRequestTest.java
 src/test/java/com/docspring/UpdateWebhookRequestTest.java
 src/test/java/com/docspring/UploadMethodTest.java
 src/test/java/com/docspring/UploadPresignTest.java
 src/test/java/com/docspring/UrlSourcePdfTest.java
+src/test/java/com/docspring/ValidateSubmissionRequestTest.java
 src/test/java/com/docspring/WebhookEventTypeTest.java
 src/test/java/com/docspring/WebhookListTest.java
 src/test/java/com/docspring/WebhookModeTest.java

CHANGELOG.md

@@ -1,3 +1,27 @@
+### 4.1.0 [October 27, 2026]
+
+- New: list_template_fields, add_template_fields, update_template_fields, remove_template_fields and
+  reorder_template_fields read and edit a template's fields (`Field`), with all their settings and their own conditional
+  logic (`dependencies`). A field's `y` is measured from the top of its page.
+- New: a template's `predefined_fields` (`PredefinedField`) and `predefined_fields_sample_data`, the field names that
+  people using the embedded template editor choose from. get_template returns them, and create_template and
+  update_template set them.
+- New: a template's `field_groups` (`FieldGroup`), the groups that its fields' names make, with their titles and the
+  settings of lists (`min_items`, `max_items`, `allow_additional_items`). get_template returns them, and update_template
+  changes them.
+- New: get_template_page_images returns an image of each page of a PDF template (`TemplatePageImages`), to see where
+  fields go.
+- New: get_template_diff says what changed in a template's draft since its latest published version, or in a published
+  version since the one before it (`TemplateDiff`).
+- New: validate_submission checks a submission's data and settings as create_submission does, without creating the
+  submission or using credits (`SubmissionValidation`). It doesn't check your account's credits.
+- New: the `png` output format, an image of each page of a submission's PDF (`files.png.pages`). Add it to
+  `output_formats` in create_submission or create_submission_batch (it adds `pdf`), or to a processed submission with
+  generate_submission_files.
+- create_template and update_template_document take a `document_url` (DocSpring downloads it) or a `document_base64`
+  instead of a `cache_id`. While the URL downloads, the template's `document.state` is `downloading`; if it can't be
+  downloaded, it's `download_failed` and `document.error_message` says why.
+
 ### 4.0.0 [October 26, 2026]
 
 - **BREAKING CHANGE**: This version calls DocSpring API v2 (`/api/v2`). The 3.x versions call API v1, which keeps