Updated on 2026-10-19 10:07:44. Version: 3.3.0

Author: ndbroadbent

.openapi-generator/FILES

@@ -30,6 +30,7 @@ docs/CustomFile.md
 docs/ErrorOrMultipleErrorsResponse.md
 docs/ErrorResponse.md
 docs/Folder.md
+docs/ForbiddenErrorResponse.md
 docs/JsonSchema.md
 docs/ListSubmissionsResponse.md
 docs/MoveFolderData.md
@@ -102,6 +103,7 @@ src/main/java/com/docspring/CustomFile.java
 src/main/java/com/docspring/ErrorOrMultipleErrorsResponse.java
 src/main/java/com/docspring/ErrorResponse.java
 src/main/java/com/docspring/Folder.java
+src/main/java/com/docspring/ForbiddenErrorResponse.java
 src/main/java/com/docspring/JSON.java
 src/main/java/com/docspring/JavaTimeFormatter.java
 src/main/java/com/docspring/JsonSchema.java
@@ -173,6 +175,7 @@ src/test/java/com/docspring/CustomFileTest.java
 src/test/java/com/docspring/ErrorOrMultipleErrorsResponseTest.java
 src/test/java/com/docspring/ErrorResponseTest.java
 src/test/java/com/docspring/FolderTest.java
+src/test/java/com/docspring/ForbiddenErrorResponseTest.java
 src/test/java/com/docspring/JsonSchemaTest.java
 src/test/java/com/docspring/ListSubmissionsResponseTest.java
 src/test/java/com/docspring/MoveFolderDataTest.java

CHANGELOG.md

@@ -1,3 +1,14 @@
+### 3.3.0 [October 18, 2026]
+
+- Submissions and combined submissions can be in the new `insufficient_credits` state: a live PDF that your credit
+  balance can't cover is saved and processed once you add credits. See
+  https://docspring.com/docs/api-guide/credits-and-rate-limits/.
+- generate_pdf, batch_generate_pdfs and combine_pdfs document the 402 response for insufficient credits. Their
+  responses can include a `code`, which is `insufficient_credits` on a 402.
+- generate_pdf, batch_generate_pdfs, create_pdf_template, create_pdf_template_from_upload, create_html_template and
+  copy_template document a 403 response with a `code` of `upgrade_required` (the plan doesn't include it) or
+  `account_suspended`.
+
 ### 3.2.0 [October 18, 2026]
 
 - Response models keep fields this version doesn't know: read them with `getAdditionalProperties()`.

README.md

@@ -6,7 +6,7 @@ templates with your data, generates PDFs from HTML templates, combines PDFs and
 [Documentation](https://docspring.com/docs/) · [API reference](https://docspring.com/docs/api/) ·
 [Maven Central](https://central.sonatype.com/artifact/com.docspring/DocSpring) · [Changelog](https://github.com/DocSpring/docspring-java/blob/main/CHANGELOG.md)
 
-Version 3.2.0. Requires Java 8 or later.
+Version 3.3.0. Requires Java 8 or later.
 
 ## Install and configure
 
@@ -16,14 +16,14 @@ Version 3.2.0. Requires Java 8 or later.
 <dependency>
   <groupId>com.docspring</groupId>
   <artifactId>DocSpring</artifactId>
-  <version>3.2.0</version>
+  <version>3.3.0</version>
 </dependency>
 ```
 
 **Gradle**: add to your `build.gradle`:
 
 ```groovy
-implementation 'com.docspring:DocSpring:3.2.0'
+implementation 'com.docspring:DocSpring:3.3.0'
 ```
 
 Configure authentication via environment variables: