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

@@ -3,6 +3,7 @@
 .gitlab-ci.yml
 .travis.yml
 README.md
+docs/AddTemplateFieldsRequest.md
 docs/AiFieldNamingLanguage.md
 docs/AuthenticationCheck.md
 docs/BarcodeSymbology.md
@@ -37,10 +38,16 @@ docs/ErrorResponse.md
 docs/ExpirationInterval.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
@@ -49,21 +56,32 @@ 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
 docs/HtmlEngineOptionsInput.md
 docs/ImageGravity.md
 docs/ImageScaleType.md
 docs/ModelCodeLanguage.md
+docs/ModelField.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
@@ -89,13 +107,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
@@ -104,12 +127,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
@@ -123,11 +149,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
@@ -140,6 +168,7 @@ docspring/api_response.py
 docspring/configuration.py
 docspring/exceptions.py
 docspring/models/__init__.py
+docspring/models/add_template_fields_request.py
 docspring/models/ai_field_naming_language.py
 docspring/models/authentication_check.py
 docspring/models/barcode_symbology.py
@@ -173,10 +202,16 @@ docspring/models/error_response.py
 docspring/models/expiration_interval.py
 docspring/models/field_comparison_condition.py
 docspring/models/field_comparison_operator.py
+docspring/models/field_dependency.py
+docspring/models/field_dependency_input.py
 docspring/models/field_display_type.py
 docspring/models/field_equals_condition.py
 docspring/models/field_equals_operator.py
+docspring/models/field_group.py
+docspring/models/field_group_input.py
+docspring/models/field_group_type.py
 docspring/models/field_in_condition.py
+docspring/models/field_input.py
 docspring/models/field_override.py
 docspring/models/field_presence_condition.py
 docspring/models/field_presence_operator.py
@@ -185,21 +220,32 @@ docspring/models/field_reimport_state.py
 docspring/models/field_setup_logic.py
 docspring/models/field_setup_naming.py
 docspring/models/field_setup_source.py
+docspring/models/field_type.py
 docspring/models/folder.py
 docspring/models/folder_list.py
+docspring/models/generate_files_format.py
+docspring/models/generate_submission_files_request.py
 docspring/models/generated_file.py
 docspring/models/generated_file_state.py
 docspring/models/html_engine_options.py
 docspring/models/html_engine_options_input.py
 docspring/models/image_gravity.py
 docspring/models/image_scale_type.py
 docspring/models/model_code_language.py
+docspring/models/model_field.py
 docspring/models/move_folder_request.py
 docspring/models/move_template_request.py
 docspring/models/number_condition_type.py
+docspring/models/output_format.py
 docspring/models/page_format.py
+docspring/models/page_image.py
+docspring/models/page_images.py
+docspring/models/predefined_field.py
+docspring/models/predefined_field_input.py
 docspring/models/publish_template_version_request.py
+docspring/models/remove_template_fields_request.py
 docspring/models/rename_folder_request.py
+docspring/models/reorder_template_fields_request.py
 docspring/models/restore_template_version_request.py
 docspring/models/shape_type.py
 docspring/models/signature_request.py
@@ -225,13 +271,18 @@ docspring/models/submission_list.py
 docspring/models/submission_source.py
 docspring/models/submission_source_pdf.py
 docspring/models/submission_state.py
+docspring/models/submission_validation.py
 docspring/models/template.py
 docspring/models/template_actor.py
 docspring/models/template_actor_type.py
 docspring/models/template_defaults.py
 docspring/models/template_defaults_input.py
+docspring/models/template_diff.py
+docspring/models/template_diff_summary.py
 docspring/models/template_document.py
 docspring/models/template_document_state.py
+docspring/models/template_field_change.py
+docspring/models/template_field_changes.py
 docspring/models/template_field_dependency.py
 docspring/models/template_field_dependency_action.py
 docspring/models/template_field_dependency_condition.py
@@ -240,12 +291,15 @@ docspring/models/template_field_dependency_input.py
 docspring/models/template_field_dependency_match.py
 docspring/models/template_field_dependency_operator.py
 docspring/models/template_field_logic_status.py
+docspring/models/template_field_move.py
+docspring/models/template_fields.py
 docspring/models/template_form_mode.py
 docspring/models/template_model_code.py
 docspring/models/template_page_ai_error.py
 docspring/models/template_page_ai_naming_status.py
 docspring/models/template_page_fields_status.py
 docspring/models/template_page_image_status.py
+docspring/models/template_page_images.py
 docspring/models/template_page_processing_status.py
 docspring/models/template_source_pdf.py
 docspring/models/template_summary.py
@@ -259,11 +313,13 @@ docspring/models/text_vertical_alignment.py
 docspring/models/typeface.py
 docspring/models/update_signature_request_request.py
 docspring/models/update_template_document_request.py
+docspring/models/update_template_fields_request.py
 docspring/models/update_template_request.py
 docspring/models/update_webhook_request.py
 docspring/models/upload_method.py
 docspring/models/upload_presign.py
 docspring/models/url_source_pdf.py
+docspring/models/validate_submission_request.py
 docspring/models/webhook.py
 docspring/models/webhook_event_type.py
 docspring/models/webhook_list.py
@@ -277,6 +333,7 @@ setup.cfg
 setup.py
 test-requirements.txt
 test/__init__.py
+test/test_add_template_fields_request.py
 test/test_ai_field_naming_language.py
 test/test_authentication_check.py
 test/test_barcode_symbology.py
@@ -311,10 +368,16 @@ test/test_error_response.py
 test/test_expiration_interval.py
 test/test_field_comparison_condition.py
 test/test_field_comparison_operator.py
+test/test_field_dependency.py
+test/test_field_dependency_input.py
 test/test_field_display_type.py
 test/test_field_equals_condition.py
 test/test_field_equals_operator.py
+test/test_field_group.py
+test/test_field_group_input.py
+test/test_field_group_type.py
 test/test_field_in_condition.py
+test/test_field_input.py
 test/test_field_override.py
 test/test_field_presence_condition.py
 test/test_field_presence_operator.py
@@ -323,21 +386,32 @@ test/test_field_reimport_state.py
 test/test_field_setup_logic.py
 test/test_field_setup_naming.py
 test/test_field_setup_source.py
+test/test_field_type.py
 test/test_folder.py
 test/test_folder_list.py
+test/test_generate_files_format.py
+test/test_generate_submission_files_request.py
 test/test_generated_file.py
 test/test_generated_file_state.py
 test/test_html_engine_options.py
 test/test_html_engine_options_input.py
 test/test_image_gravity.py
 test/test_image_scale_type.py
 test/test_model_code_language.py
+test/test_model_field.py
 test/test_move_folder_request.py
 test/test_move_template_request.py
 test/test_number_condition_type.py
+test/test_output_format.py
 test/test_page_format.py
+test/test_page_image.py
+test/test_page_images.py
+test/test_predefined_field.py
+test/test_predefined_field_input.py
 test/test_publish_template_version_request.py
+test/test_remove_template_fields_request.py
 test/test_rename_folder_request.py
+test/test_reorder_template_fields_request.py
 test/test_restore_template_version_request.py
 test/test_shape_type.py
 test/test_signature_request.py
@@ -363,13 +437,18 @@ test/test_submission_list.py
 test/test_submission_source.py
 test/test_submission_source_pdf.py
 test/test_submission_state.py
+test/test_submission_validation.py
 test/test_template.py
 test/test_template_actor.py
 test/test_template_actor_type.py
 test/test_template_defaults.py
 test/test_template_defaults_input.py
+test/test_template_diff.py
+test/test_template_diff_summary.py
 test/test_template_document.py
 test/test_template_document_state.py
+test/test_template_field_change.py
+test/test_template_field_changes.py
 test/test_template_field_dependency.py
 test/test_template_field_dependency_action.py
 test/test_template_field_dependency_condition.py
@@ -378,12 +457,15 @@ test/test_template_field_dependency_input.py
 test/test_template_field_dependency_match.py
 test/test_template_field_dependency_operator.py
 test/test_template_field_logic_status.py
+test/test_template_field_move.py
+test/test_template_fields.py
 test/test_template_form_mode.py
 test/test_template_model_code.py
 test/test_template_page_ai_error.py
 test/test_template_page_ai_naming_status.py
 test/test_template_page_fields_status.py
 test/test_template_page_image_status.py
+test/test_template_page_images.py
 test/test_template_page_processing_status.py
 test/test_template_source_pdf.py
 test/test_template_summary.py
@@ -397,11 +479,13 @@ test/test_text_vertical_alignment.py
 test/test_typeface.py
 test/test_update_signature_request_request.py
 test/test_update_template_document_request.py
+test/test_update_template_fields_request.py
 test/test_update_template_request.py
 test/test_update_webhook_request.py
 test/test_upload_method.py
 test/test_upload_presign.py
 test/test_url_source_pdf.py
+test/test_validate_submission_request.py
 test/test_webhook.py
 test/test_webhook_event_type.py
 test/test_webhook_list.py

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