Updated on 2026-10-18 17:00:29. Version: 3.2.0

Author: ndbroadbent

AGENTS.md

@@ -0,0 +1,33 @@
+# AGENTS.md
+
+Notes for AI coding agents working with the DocSpring Java SDK (`com.docspring:DocSpring`), in this repository or
+as a dependency of an app.
+
+## This code is generated
+
+Every file here is generated from DocSpring's OpenAPI spec by
+[DocSpring's fork of OpenAPI Generator](https://github.com/DocSpring/openapi-generator/tree/docspring/all_patches), and each release replaces
+all of it. Don't edit it or open pull requests that change it, and don't patch an installed copy: the next release
+overwrites the change. Report bugs at https://github.com/DocSpring/docspring-java/issues or to support@docspring.com, and DocSpring fixes them in
+the generator.
+
+## Where to look
+
+- [README.md](README.md): install, configuration, an example and how errors and API changes are handled.
+- [docs/Client.md](https://github.com/DocSpring/docspring-java/blob/main/docs/Client.md): every method, with its parameters and return type.
+- [docs/](https://github.com/DocSpring/docspring-java/tree/main/docs): every model and its fields.
+- https://docspring.com/docs/llms.txt: DocSpring's documentation for LLMs (`llms-small.txt`, `llms-full.txt`).
+- https://docspring.com/docs/api/: the API reference, with Java code for every method.
+- https://docspring.com/api-docs/v1/openapi.json: the OpenAPI spec this SDK is generated from.
+
+## Using it in an app
+
+- Credentials come from `DOCSPRING_TOKEN_ID` and `DOCSPRING_TOKEN_SECRET`. Keep them in the environment or a secret
+  store, never in code. Accounts in the EU region also need `DOCSPRING_REGION=EU`.
+- Template IDs look like `tpl_...` and submission IDs like `sub_...`.
+- Pass `test: true` when you generate PDFs during development: test PDFs are free and watermarked.
+- Generating a PDF waits for it, for up to 95 seconds. For many PDFs or slow templates, set `wait` to false and use
+  webhooks or check the submission later (https://docspring.com/docs/api-guide/synchronous-requests/).
+- Errors: Methods throw `com.docspring.ApiException` for an error response, with the HTTP status in `getCode()` and the body in `getResponseBody()`.
+- Responses can be newer than this SDK, because DocSpring adds fields and enum values to API v1 without a new
+  version. The model keeps a response field added to the API after this release in its additional properties (`getAdditionalProperties()`). An enum value added to the API after this release comes back as `UNKNOWN_DEFAULT_OPEN_API`, so give each `switch` over an enum a case or default for it.

CHANGELOG.md

@@ -1,3 +1,14 @@
+### 3.2.0 [October 18, 2026]
+
+- Response models keep fields this version doesn't know: read them with `getAdditionalProperties()`.
+- In an enum that can be null (such as a webhook's `mode`), a value this version doesn't know now reads as
+  `UNKNOWN_DEFAULT_OPEN_API` instead of null.
+- Templates: new `parse_dates_using_template_date_format` setting, when you create or update a template. When it's
+  true, date values sent as NN/NN/YYYY (with slashes, dashes or dots) are read in the order of the template's default
+  date format: month first for `%m/%d/%Y`, day first for `%d/%m/%Y`. When it's false, they're read day first.
+- A new README: installing, a quick start, every API method, errors, and how API changes are handled. The repository
+  also has an AGENTS.md for coding agents.
+
 ### 3.1.0 [October 15, 2026]
 
 - Submissions and data requests can now be in the `declined` state, when a signer declines to sign. Data