Update to version 4.4.0 on 2026-11-01

- New: list_email_actions, create_email_action, get_email_action, update_email_action and delete_email_action manage a
  template's email actions (`EmailAction`), which email each processed submission's files as attachments or a download
  link. `to`, `cc` and `bcc` take addresses, and tags for an address in the submission's fields
  (`{{ data.client_email }}`) or metadata (`{{ metadata.agent_email }}`). `send_when` sends only for the submissions
  that meet its conditions. `file_name` names the attached files, and `file_formats` chooses them: a Word template's
  Word document (`docx`), OpenDocument file (`odt`) or PDF (`pdf`), or every file the submission made (`all`). Attached
  files over `max_attachment_mb` together (7 MB unless you raise it, up to 25) go as a link instead.
  send_email_action_test_email sends one to you to check how it looks (`EmailActionTestEmail`). Without a paid plan
  (Starter or higher), email actions only email your team: test emails, and test submissions' emails.
- New: list_account_email_actions, create_account_email_action, get_account_email_action, update_account_email_action
  and delete_account_email_action manage your account's email actions, which send for every template, or for the
  templates and folders they list (`template_ids`, `folder_ids`). send_account_email_action_test_email sends one to you
  for one of its templates.
- New: list_email_actions also lists your account's email actions that send for the template, with the template's
  changes in `customization` (`EmailActionCustomization`). update_email_action_customization changes one for that
  template only, or turns it off there (`enabled`), and delete_email_action_customization removes the template's
  changes.
- New: list_email_domains, create_email_domain, get_email_domain, verify_email_domain and delete_email_domain manage the
  domains your email actions send from (`EmailDomain`), with the DNS records to add to each one (`EmailDomainDnsRecord`).
- A submission's `actions` include the emails its email actions sent (its template's and your account's), with each
  recipient and what happened to their email, and a new `email_action_id`.
- New: a field's `string_condition_type` can be `not_equals`, `not_contains`, `not_starts_with`, `not_ends_with`,
  `not_regex`, `blank` or `not_blank`, and a `regex` condition uses RE2 syntax (no lookarounds or backreferences).
- create_submission: DocSpring now emails the signers of a submission's `signature_requests` a link to sign, any
  reminders, and the signed PDF once everyone has signed. Set `send_email` to false, for the submission or for one
  signature request, when you send the links yourself or show the signing form in your app. A signature request that
  DocSpring emails needs an `email`, and its `auth_type` is optional (`email_link`). Before anyone is emailed, the
  request can be refused with a 402 (`insufficient_credits_to_send`), a 403 or a 429 (`daily_email_limit_reached`), and
  nothing is saved.
- New create_submission properties for these emails: `signing_order` (`SigningOrder`) with each signature request's
  `signing_step`, `email_subject`, `email_message`, `cc`, `reply_to`, `notification_emails`, `notify_when_signed` and
  `reminders` (`SignatureRequestReminders`).
- A signature request has `send_email`, `signing_step`, `sent_at` and `email_status` (`SignatureRequestEmailStatus`),
  and a submission has `signing_order`.
- Templates have new settings for these emails: `signature_request_from_name`, `signature_request_from_address`,
  `signature_request_signing_url`, `signature_request_include_signing_token`, `signature_request_reply_to`,
  `signature_request_notification_emails` and `signature_request_email_attachments`
  (`SignatureRequestEmailAttachments`).
- New webhook event types: `signature_request.sent` and `signature_request.email_bounced`.
- New: page designs (`template_type` `page_designer`), PDFs designed in the Page Designer from a JSON layout, with no
  document to start from. create_template makes one from its `layout`, or with an empty page when `layout` is left
  out, and update_template replaces its layout. DocSpring adds a field for each value the layout reads. A template's
  `layout` is in the [Page Designer layout format](https://docspring.com/docs/page-designer/layout-format/) (its
  [JSON Schema](https://docspring.com/schemas/page-designer/layout.v1.json)), and is null for other templates.
- New: every method that creates, changes or deletes something takes an `Idempotency-Key` header, as its last argument,
  `idempotency_key`. Send the same key when you send a request again after a timeout or a network error: within 24
  hours, DocSpring returns the first response instead of running the request twice. Arguments you already pass keep
  their places.
- Changed: the request validator checks what API v2 now refuses: an ID, a query value or a template name that's blank or
  only whitespace, an update with nothing to change, a version with a leading zero (`01`), a `filename` with a slash, a
  signer `email` that isn't an email address, and an HTML template's `scale` outside 0.1 to 2.
- New: get_template_model_code takes `rust` as its `lang`, for Rust structs that serde reads and writes.

Author: ndbroadbent

.github/workflows/python.yml

@@ -0,0 +1,74 @@
+# Written by DocSpring/docspring's api_clients/scripts/generate from api_clients/github_workflows/python/release.yml:
+# change it there.
+#
+# Builds the package on every push and pull request. A v* tag (pushed by the monorepo's api_clients/scripts/release)
+# also publishes it to PyPI with trusted publishing, in the release environment, and waits until PyPI serves it.
+# OpenAPI Generator's python.yml runs the package's tests.
+name: Release
+
+on:
+  push:
+    branches: ['**']
+    tags: ['v*']
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+      - name: Check the tag matches the package version
+        if: github.ref_type == 'tag'
+        run: |
+          VERSION="$(python3 -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')"
+          if [ "v$VERSION" != "$GITHUB_REF_NAME" ]; then
+            echo "::error::The tag is $GITHUB_REF_NAME, but the package version is $VERSION"
+            exit 1
+          fi
+      - run: uv build --wheel
+      - run: uvx twine check --strict dist/*
+      - if: github.ref_type == 'tag'
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: package
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    needs: build
+    if: github.ref_type == 'tag'
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: package
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
+
+  verify:
+    needs: publish
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Wait until PyPI serves the version
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          for _ in $(seq 60); do
+            if curl -fsS -o /dev/null "https://pypi.org/pypi/docspring/$VERSION/json"; then
+              echo "PyPI serves docspring $VERSION"
+              exit 0
+            fi
+            sleep 10
+          done
+          echo "::error::PyPI doesn't serve docspring $VERSION after 10 minutes"
+          exit 1

.github/workflows/release.yml

@@ -19,8 +19,11 @@ docs/CombinedPdfSourcePdf.md
 docs/CombinedPdfSourceType.md
 docs/CombinedPdfState.md
 docs/CopyTemplateRequest.md
+docs/CreateAccountEmailActionRequest.md
 docs/CreateCombinedPdfRequest.md
 docs/CreateCustomFileFromUploadRequest.md
+docs/CreateEmailActionRequest.md
+docs/CreateEmailDomainRequest.md
 docs/CreateFolderRequest.md
 docs/CreateSignatureRequestEventRequest.md
 docs/CreateSignatureRequestTokenRequest.md
@@ -32,6 +35,23 @@ docs/CreateWebhookRequest.md
 docs/CustomFile.md
 docs/CustomFileList.md
 docs/CustomFileSourcePdf.md
+docs/DnsRecordType.md
+docs/EmailAction.md
+docs/EmailActionConditions.md
+docs/EmailActionConditionsInput.md
+docs/EmailActionCustomization.md
+docs/EmailActionDelivery.md
+docs/EmailActionFileFormats.md
+docs/EmailActionList.md
+docs/EmailActionSetting.md
+docs/EmailActionSubmissionType.md
+docs/EmailActionTestEmail.md
+docs/EmailDomain.md
+docs/EmailDomainDnsRecord.md
+docs/EmailDomainDnsRecordPurpose.md
+docs/EmailDomainList.md
+docs/EmailDomainRecordState.md
+docs/EmailDomainState.md
 docs/ErrorCode.md
 docs/ErrorDetail.md
 docs/ErrorInfo.md
@@ -84,17 +104,22 @@ docs/RemoveTemplateFieldsRequest.md
 docs/RenameFolderRequest.md
 docs/ReorderTemplateFieldsRequest.md
 docs/RestoreTemplateVersionRequest.md
+docs/SendAccountEmailActionTestEmailRequest.md
 docs/ShapeType.md
 docs/SignatureRequest.md
 docs/SignatureRequestAuthSecondFactorType.md
 docs/SignatureRequestAuthType.md
+docs/SignatureRequestEmailAttachments.md
+docs/SignatureRequestEmailStatus.md
 docs/SignatureRequestEvent.md
 docs/SignatureRequestEventType.md
 docs/SignatureRequestInput.md
 docs/SignatureRequestMessageType.md
+docs/SignatureRequestReminders.md
 docs/SignatureRequestState.md
 docs/SignatureRequestToken.md
 docs/SignatureRequestTokenType.md
+docs/SigningOrder.md
 docs/StringConditionType.md
 docs/Submission.md
 docs/SubmissionAction.md
@@ -152,6 +177,9 @@ docs/TextAlignment.md
 docs/TextOverflow.md
 docs/TextVerticalAlignment.md
 docs/Typeface.md
+docs/UpdateAccountEmailActionRequest.md
+docs/UpdateEmailActionCustomizationRequest.md
+docs/UpdateEmailActionRequest.md
 docs/UpdateSignatureRequestRequest.md
 docs/UpdateTemplateDocumentRequest.md
 docs/UpdateTemplateFieldsRequest.md
@@ -188,8 +216,11 @@ docspring/models/combined_pdf_source_pdf.py
 docspring/models/combined_pdf_source_type.py
 docspring/models/combined_pdf_state.py
 docspring/models/copy_template_request.py
+docspring/models/create_account_email_action_request.py
 docspring/models/create_combined_pdf_request.py
 docspring/models/create_custom_file_from_upload_request.py
+docspring/models/create_email_action_request.py
+docspring/models/create_email_domain_request.py
 docspring/models/create_folder_request.py
 docspring/models/create_signature_request_event_request.py
 docspring/models/create_signature_request_token_request.py
@@ -201,6 +232,23 @@ docspring/models/create_webhook_request.py
 docspring/models/custom_file.py
 docspring/models/custom_file_list.py
 docspring/models/custom_file_source_pdf.py
+docspring/models/dns_record_type.py
+docspring/models/email_action.py
+docspring/models/email_action_conditions.py
+docspring/models/email_action_conditions_input.py
+docspring/models/email_action_customization.py
+docspring/models/email_action_delivery.py
+docspring/models/email_action_file_formats.py
+docspring/models/email_action_list.py
+docspring/models/email_action_setting.py
+docspring/models/email_action_submission_type.py
+docspring/models/email_action_test_email.py
+docspring/models/email_domain.py
+docspring/models/email_domain_dns_record.py
+docspring/models/email_domain_dns_record_purpose.py
+docspring/models/email_domain_list.py
+docspring/models/email_domain_record_state.py
+docspring/models/email_domain_state.py
 docspring/models/error_code.py
 docspring/models/error_detail.py
 docspring/models/error_info.py
@@ -253,17 +301,22 @@ 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/send_account_email_action_test_email_request.py
 docspring/models/shape_type.py
 docspring/models/signature_request.py
 docspring/models/signature_request_auth_second_factor_type.py
 docspring/models/signature_request_auth_type.py
+docspring/models/signature_request_email_attachments.py
+docspring/models/signature_request_email_status.py
 docspring/models/signature_request_event.py
 docspring/models/signature_request_event_type.py
 docspring/models/signature_request_input.py
 docspring/models/signature_request_message_type.py
+docspring/models/signature_request_reminders.py
 docspring/models/signature_request_state.py
 docspring/models/signature_request_token.py
 docspring/models/signature_request_token_type.py
+docspring/models/signing_order.py
 docspring/models/string_condition_type.py
 docspring/models/submission.py
 docspring/models/submission_action.py
@@ -321,6 +374,9 @@ docspring/models/text_alignment.py
 docspring/models/text_overflow.py
 docspring/models/text_vertical_alignment.py
 docspring/models/typeface.py
+docspring/models/update_account_email_action_request.py
+docspring/models/update_email_action_customization_request.py
+docspring/models/update_email_action_request.py
 docspring/models/update_signature_request_request.py
 docspring/models/update_template_document_request.py
 docspring/models/update_template_fields_request.py
@@ -359,8 +415,11 @@ test/test_combined_pdf_source_pdf.py
 test/test_combined_pdf_source_type.py
 test/test_combined_pdf_state.py
 test/test_copy_template_request.py
+test/test_create_account_email_action_request.py
 test/test_create_combined_pdf_request.py
 test/test_create_custom_file_from_upload_request.py
+test/test_create_email_action_request.py
+test/test_create_email_domain_request.py
 test/test_create_folder_request.py
 test/test_create_signature_request_event_request.py
 test/test_create_signature_request_token_request.py
@@ -372,6 +431,23 @@ test/test_create_webhook_request.py
 test/test_custom_file.py
 test/test_custom_file_list.py
 test/test_custom_file_source_pdf.py
+test/test_dns_record_type.py
+test/test_email_action.py
+test/test_email_action_conditions.py
+test/test_email_action_conditions_input.py
+test/test_email_action_customization.py
+test/test_email_action_delivery.py
+test/test_email_action_file_formats.py
+test/test_email_action_list.py
+test/test_email_action_setting.py
+test/test_email_action_submission_type.py
+test/test_email_action_test_email.py
+test/test_email_domain.py
+test/test_email_domain_dns_record.py
+test/test_email_domain_dns_record_purpose.py
+test/test_email_domain_list.py
+test/test_email_domain_record_state.py
+test/test_email_domain_state.py
 test/test_error_code.py
 test/test_error_detail.py
 test/test_error_info.py
@@ -424,17 +500,22 @@ 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_send_account_email_action_test_email_request.py
 test/test_shape_type.py
 test/test_signature_request.py
 test/test_signature_request_auth_second_factor_type.py
 test/test_signature_request_auth_type.py
+test/test_signature_request_email_attachments.py
+test/test_signature_request_email_status.py
 test/test_signature_request_event.py
 test/test_signature_request_event_type.py
 test/test_signature_request_input.py
 test/test_signature_request_message_type.py
+test/test_signature_request_reminders.py
 test/test_signature_request_state.py
 test/test_signature_request_token.py
 test/test_signature_request_token_type.py
+test/test_signing_order.py
 test/test_string_condition_type.py
 test/test_submission.py
 test/test_submission_action.py
@@ -492,6 +573,9 @@ test/test_text_alignment.py
 test/test_text_overflow.py
 test/test_text_vertical_alignment.py
 test/test_typeface.py
+test/test_update_account_email_action_request.py
+test/test_update_email_action_customization_request.py
+test/test_update_email_action_request.py
 test/test_update_signature_request_request.py
 test/test_update_template_document_request.py
 test/test_update_template_fields_request.py