Update to version 4.3.0 on 2026-10-31

- New: get_template_model_code takes `rust` as its `lang`, for Rust structs that serde reads and writes.
- New: Word templates (`template_type` `docx`). create_template makes one from a Word document (.docx, up to 50 MB)
  that you upload and pass as a `cache_id`, or pass as a `document_url` or `document_base64`; upload_template takes the
  file itself. update_template_document and upload_template_document replace its document the same ways. Each tag in
  the document, such as `{{ customer.name }}`, becomes a field. Each of them takes an OpenDocument text file (.odt)
  too, which DocSpring converts to a Word document.
- New: a Word template's `output_format`, what its submissions make unless they set `output_formats`: `docx` (a Word
  document), `odt` (an OpenDocument file) or `pdf`. create_template and upload_template require it, and
  update_template changes it. A Word template that encrypts its PDFs makes PDFs, because Word documents and
  OpenDocument files can't be password-protected.
- New: the `docx` and `odt` output formats, a Word template's filled-in Word document (`files.docx`) and OpenDocument
  file (`files.odt`, converted from the Word document). Add them to `output_formats` in create_submission or
  create_submission_batch to get more than one file, such as the Word document and the PDF.
- generate_submission_files takes `pdf`, the PDF of a Word template's submission that didn't make one (converted from
  its Word document), `docx`, the Word document of one that made only its PDF (made again from its data and the
  template version it used), and `odt`, its OpenDocument file. None of them uses credits again. Until the new file is
  ready, its `state` in `files` is `pending`, and when it couldn't be made, its `error_message` says why.
- A Word template's `document` is its Word document: `document.permanent_url` downloads it. Its `state` is `processed`
  once it's uploaded or downloaded (`downloading` or `download_failed` while a `document_url` downloads, `converting`
  or `conversion_failed` while an OpenDocument file is converted), and get_template_diff's `document_changed` says
  whether it was edited.
- get_template_page_images returns a 409 for a Word template, whose pages are only laid out when a document is made.
- create_template_preview previews Word templates too: images of the pages of the PDF that the template's Word
  document makes with your data. A DocSpring server that can't convert Word documents to PDF returns a 409.

Author: ndbroadbent

AGENTS.md

@@ -90,5 +90,5 @@ keeps it.
 
 - List methods return `data` and `next_cursor`: pass `next_cursor` as `cursor` to get the next page.
 - Responses can be newer than this SDK, because DocSpring adds fields and enum values to API v2 without a new
-  version. The model keeps a response field added to the API after this release in its `additional_properties` dict. The objects defined inside a model, such as a template's `document`, leave it out. Enum values in responses are strings, so a
-  value added after this release comes back as it is: handle values you don't recognize.
+  version. The model keeps a response field added to the API after this release in its `additional_properties` dict. The objects defined inside a model, such as a template's `document`, leave it out. An enum value added after this release comes
+  back as the API sent it: handle values you don't recognize.

CHANGELOG.md

@@ -1,3 +1,30 @@
+### 4.3.0 [October 31, 2026]
+
+- New: get_template_model_code takes `rust` as its `lang`, for Rust structs that serde reads and writes.
+- New: Word templates (`template_type` `docx`). create_template makes one from a Word document (.docx, up to 50 MB)
+  that you upload and pass as a `cache_id`, or pass as a `document_url` or `document_base64`; upload_template takes the
+  file itself. update_template_document and upload_template_document replace its document the same ways. Each tag in
+  the document, such as `{{ customer.name }}`, becomes a field. Each of them takes an OpenDocument text file (.odt)
+  too, which DocSpring converts to a Word document.
+- New: a Word template's `output_format`, what its submissions make unless they set `output_formats`: `docx` (a Word
+  document), `odt` (an OpenDocument file) or `pdf`. create_template and upload_template require it, and
+  update_template changes it. A Word template that encrypts its PDFs makes PDFs, because Word documents and
+  OpenDocument files can't be password-protected.
+- New: the `docx` and `odt` output formats, a Word template's filled-in Word document (`files.docx`) and OpenDocument
+  file (`files.odt`, converted from the Word document). Add them to `output_formats` in create_submission or
+  create_submission_batch to get more than one file, such as the Word document and the PDF.
+- generate_submission_files takes `pdf`, the PDF of a Word template's submission that didn't make one (converted from
+  its Word document), `docx`, the Word document of one that made only its PDF (made again from its data and the
+  template version it used), and `odt`, its OpenDocument file. None of them uses credits again. Until the new file is
+  ready, its `state` in `files` is `pending`, and when it couldn't be made, its `error_message` says why.
+- A Word template's `document` is its Word document: `document.permanent_url` downloads it. Its `state` is `processed`
+  once it's uploaded or downloaded (`downloading` or `download_failed` while a `document_url` downloads, `converting`
+  or `conversion_failed` while an OpenDocument file is converted), and get_template_diff's `document_changed` says
+  whether it was edited.
+- get_template_page_images returns a 409 for a Word template, whose pages are only laid out when a document is made.
+- create_template_preview previews Word templates too: images of the pages of the PDF that the template's Word
+  document makes with your data. A DocSpring server that can't convert Word documents to PDF returns a 409.
+
 ### 4.2.0 [October 29, 2026]
 
 - **BREAKING CHANGE**: list_templates returns a shorter `TemplateSummary`: a template's name, description, type, folder

README.md

@@ -1,15 +1,16 @@
 # DocSpring Python SDK
 
 The official Python client for the [DocSpring API](https://docspring.com/docs/api/). DocSpring fills PDF
-templates with your data, generates PDFs from HTML templates, combines PDFs and collects e-signatures.
+forms with your data, generates PDFs and Word documents from HTML and Word templates, combines PDFs and collects
+e-signatures.
 
 [Documentation](https://docspring.com/docs/) · [API reference](https://docspring.com/docs/api/) ·
 [PyPI](https://pypi.org/project/docspring/) · [Changelog](https://github.com/DocSpring/docspring-python/blob/main/CHANGELOG.md)
 
 The code in this repository is generated from DocSpring's OpenAPI spec ([About this SDK](#about-this-sdk)). Issues and
 pull requests are welcome.
 
-Version 4.2.0. Requires Python >=3.10.
+Version 4.3.0. Requires Python >=3.10.
 
 ## Install and configure
 
@@ -132,11 +133,11 @@ Python code for every method.
 | [`test_authentication`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#test_authentication) | Test authentication |
 | [`update_signature_request`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#update_signature_request) | Update a signature request |
 | [`update_template`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#update_template) | Update a template |
-| [`update_template_document`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#update_template_document) | Replace a template's PDF |
+| [`update_template_document`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#update_template_document) | Replace a template's document |
 | [`update_template_fields`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#update_template_fields) | Update a template's fields |
 | [`update_webhook`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#update_webhook) | Update a webhook |
-| [`upload_template`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#upload_template) | Create a PDF template from an uploaded PDF |
-| [`upload_template_document`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#upload_template_document) | Replace a template's PDF with an uploaded PDF |
+| [`upload_template`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#upload_template) | Create a template from an uploaded PDF or Word document |
+| [`upload_template_document`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#upload_template_document) | Replace a template's document with an uploaded file |
 | [`validate_submission`](https://github.com/DocSpring/docspring-python/blob/main/docs/Client.md#validate_submission) | Check a submission without creating it |
 
 ## Errors
@@ -154,7 +155,7 @@ existing code, such as removing or renaming a field, go in a new API version
 responses that are newer than it is:
 
 - The model keeps a response field added to the API after this release in its `additional_properties` dict. The objects defined inside a model, such as a template's `document`, leave it out.
-- Enum values in responses are strings, so a value added to the API after this release comes back as it is: handle values you don't recognize.
+- An enum value added to the API after this release comes back as the API sent it: handle values you don't recognize.
 
 Upgrade the SDK to read new fields and enum values. The [changelog](https://github.com/DocSpring/docspring-python/blob/main/CHANGELOG.md) lists
 what each release adds.

docs/AddTemplateFieldsRequest.md

@@ -25,6 +25,6 @@ add_template_fields_request_dict = add_template_fields_request_instance.to_dict(
 # create an instance of AddTemplateFieldsRequest from a dict
 add_template_fields_request_from_dict = AddTemplateFieldsRequest.from_dict(add_template_fields_request_dict)
 ```
-[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+[[Back to Model list]](../README.md#methods) [[Back to API list]](../README.md#methods) [[Back to README]](../README.md)
 
 

docs/AiFieldNamingLanguage.md

@@ -10,6 +10,6 @@ The language AI field setup names a PDF template's fields in.
 
 * `FORM_LANGUAGE` (value: `'form_language'`)
 
-[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+[[Back to Model list]](../README.md#methods) [[Back to API list]](../README.md#methods) [[Back to README]](../README.md)
 
 

docs/AuthenticationCheck.md

@@ -25,6 +25,6 @@ authentication_check_dict = authentication_check_instance.to_dict()
 # create an instance of AuthenticationCheck from a dict
 authentication_check_from_dict = AuthenticationCheck.from_dict(authentication_check_dict)
 ```
-[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+[[Back to Model list]](../README.md#methods) [[Back to API list]](../README.md#methods) [[Back to README]](../README.md)
 
 

docs/BarcodeSymbology.md

@@ -20,6 +20,6 @@ A kind of barcode.
 
 * `PDF417` (value: `'pdf417'`)
 
-[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+[[Back to Model list]](../README.md#methods) [[Back to API list]](../README.md#methods) [[Back to README]](../README.md)
 
 

docs/CheckCharacter.md

@@ -14,6 +14,6 @@ A check mark or cross, as the HTML entity of its character: ✓ (`✓`), 
 
 * `AMPERSAND_HASH_10008_SEMICOLON` (value: `'✘'`)
 
-[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+[[Back to Model list]](../README.md#methods) [[Back to API list]](../README.md#methods) [[Back to README]](../README.md)