docspring 3.3.0 → 3.5.0

data/docs/CreateCustomFileResponse.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **status** | **String** |  |  |
 | **custom_file** | [**CustomFile**](CustomFile.md) |  |  |
+| **error** | **String** |  | [optional] |
 | **errors** | **Array<String>** |  | [optional] |
 
 ## Example
@@ -16,6 +17,7 @@ require 'docspring'
 instance = DocSpring::CreateCustomFileResponse.new(
   status: null,
   custom_file: null,
+  error: null,
   errors: null
 )
 ```

data/docs/CreatePdfSubmissionData.md

@@ -11,7 +11,7 @@
 | **field_overrides** | **Object** |  | [optional] |
 | **metadata** | **Object** |  | [optional] |
 | **password** | **String** |  | [optional] |
-| **test** | **Boolean** |  | [optional] |
+| **test** | **Boolean** | Generate a watermarked test PDF. Test PDFs are free; live PDFs (the default) use credits. | [optional] |
 | **version** | **String** |  | [optional] |
 
 ## Example

data/docs/CreateSubmissionDataRequestEventResponse.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **status** | **String** |  |  |
 | **event** | [**SubmissionDataRequestEvent**](SubmissionDataRequestEvent.md) |  |  |
+| **error** | **String** |  | [optional] |
 | **errors** | **Array<String>** |  | [optional] |
 
 ## Example
@@ -16,6 +17,7 @@ require 'docspring'
 instance = DocSpring::CreateSubmissionDataRequestEventResponse.new(
   status: null,
   event: null,
+  error: null,
   errors: null
 )
 ```

data/docs/CreateSubmissionDataRequestResponse.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **status** | **String** |  |  |
 | **data_request** | [**SubmissionDataRequestShow**](SubmissionDataRequestShow.md) |  |  |
+| **error** | **String** |  | [optional] |
 | **errors** | **Array<String>** |  | [optional] |
 
 ## Example
@@ -16,6 +17,7 @@ require 'docspring'
 instance = DocSpring::CreateSubmissionDataRequestResponse.new(
   status: null,
   data_request: null,
+  error: null,
   errors: null
 )
 ```

data/docs/CreateSubmissionDataRequestTokenResponse.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **status** | **String** |  |  |
 | **token** | [**SubmissionDataRequestToken**](SubmissionDataRequestToken.md) |  |  |
+| **error** | **String** |  | [optional] |
 | **errors** | **Array<String>** |  | [optional] |
 
 ## Example
@@ -16,6 +17,7 @@ require 'docspring'
 instance = DocSpring::CreateSubmissionDataRequestTokenResponse.new(
   status: null,
   token: null,
+  error: null,
   errors: null
 )
 ```

data/docs/CreateSubmissionResponse.md

@@ -6,7 +6,9 @@
 | ---- | ---- | ----------- | ----- |
 | **status** | **String** |  |  |
 | **submission** | [**SubmissionPreview**](SubmissionPreview.md) |  |  |
+| **error** | **String** |  | [optional] |
 | **errors** | **Array<String>** |  | [optional] |
+| **code** | **String** | `insufficient_credits` when the response is a 402. | [optional] |
 
 ## Example
 
@@ -16,7 +18,9 @@ require 'docspring'
 instance = DocSpring::CreateSubmissionResponse.new(
   status: null,
   submission: null,
-  errors: null
+  error: null,
+  errors: null,
+  code: null
 )
 ```
 

data/docs/ForbiddenErrorResponse.md

@@ -0,0 +1,22 @@
+# DocSpring::ForbiddenErrorResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** |  |  |
+| **error** | **String** |  |  |
+| **code** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'docspring'
+
+instance = DocSpring::ForbiddenErrorResponse.new(
+  status: null,
+  error: null,
+  code: null
+)
+```
+

data/docs/SubmissionBatchData.md

@@ -8,7 +8,7 @@
 | **submissions** | **Array<Object>** |  |  |
 | **template_id** | **String** |  | [optional] |
 | **template_version** | **String** |  | [optional] |
-| **test** | **Boolean** |  | [optional] |
+| **test** | **Boolean** | Generate a watermarked test PDF. Test PDFs are free; live PDFs (the default) use credits. | [optional] |
 
 ## Example
 

data/docs/Template.md

@@ -33,6 +33,7 @@
 | **page_count** | **Integer** |  |  |
 | **page_dimensions** | **Array<Array<Float>>** |  |  |
 | **parent_folder_id** | **String** |  |  |
+| **parse_dates_using_template_date_format** | **Boolean** |  |  |
 | **path** | **String** |  |  |
 | **permanent_document_url** | **String** |  |  |
 | **public_submissions** | **Boolean** |  |  |
@@ -102,6 +103,7 @@ instance = DocSpring::Template.new(
   page_count: null,
   page_dimensions: null,
   parent_folder_id: null,
+  parse_dates_using_template_date_format: null,
   path: null,
   permanent_document_url: null,
   public_submissions: null,

data/docs/TemplatePreview.md

@@ -33,6 +33,7 @@
 | **page_count** | **Integer** |  |  |
 | **page_dimensions** | **Array<Array<Float>>** |  |  |
 | **parent_folder_id** | **String** |  |  |
+| **parse_dates_using_template_date_format** | **Boolean** |  |  |
 | **path** | **String** |  |  |
 | **permanent_document_url** | **String** |  |  |
 | **public_submissions** | **Boolean** |  |  |
@@ -89,6 +90,7 @@ instance = DocSpring::TemplatePreview.new(
   page_count: null,
   page_dimensions: null,
   parent_folder_id: null,
+  parse_dates_using_template_date_format: null,
   path: null,
   permanent_document_url: null,
   public_submissions: null,

data/docspring.gemspec

@@ -3,7 +3,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 

data/lib/docspring/api/client.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 
@@ -135,7 +135,7 @@ end
     end
 
     # Generate multiple PDFs
-    # Generates up to 50 PDFs in a single request. Each submission can use a different template and data. Supports both synchronous (wait for all PDFs) and asynchronous processing. More efficient than individual requests when creating multiple PDFs.  See also: - [Batch Generate PDFs](https://docspring.com/docs/api-guide/generate-pdfs/batch-generate-pdfs/) - Request format, responses, and limits 
+    # Generates up to 50 PDFs in a single request. Each submission can use a different template and data. Supports both synchronous (wait for all PDFs) and asynchronous processing. More efficient than individual requests when creating multiple PDFs.  Live PDFs use credits. If any live submission is waiting for credits, the API returns 402 and the others are still processed: check each submission's `state`. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).  See also: - [Batch Generate PDFs](https://docspring.com/docs/api-guide/generate-pdfs/batch-generate-pdfs/) - Request format, responses, and limits 
     # @param data [SubmissionBatchData] 
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :wait Wait for submission batch to be processed before returning. Set to false to return immediately. Default: true (on sync.* subdomain) (default to true)
@@ -146,7 +146,7 @@ end
     end
 
     # Generate multiple PDFs
-    # Generates up to 50 PDFs in a single request. Each submission can use a different template and data. Supports both synchronous (wait for all PDFs) and asynchronous processing. More efficient than individual requests when creating multiple PDFs.  See also: - [Batch Generate PDFs](https://docspring.com/docs/api-guide/generate-pdfs/batch-generate-pdfs/) - Request format, responses, and limits 
+    # Generates up to 50 PDFs in a single request. Each submission can use a different template and data. Supports both synchronous (wait for all PDFs) and asynchronous processing. More efficient than individual requests when creating multiple PDFs.  Live PDFs use credits. If any live submission is waiting for credits, the API returns 402 and the others are still processed: check each submission's `state`. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).  See also: - [Batch Generate PDFs](https://docspring.com/docs/api-guide/generate-pdfs/batch-generate-pdfs/) - Request format, responses, and limits 
     # @param data [SubmissionBatchData] 
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :wait Wait for submission batch to be processed before returning. Set to false to return immediately. Default: true (on sync.* subdomain) (default to true)
@@ -206,7 +206,7 @@ end
     end
 
     # Merge submission PDFs, template PDFs, or custom files
-    # Combines multiple PDFs from various sources into a single PDF file. Supports merging submission PDFs, template PDFs, custom files, other merged PDFs, and PDFs from URLs. Merges the PDFs in the order provided. 
+    # Combines multiple PDFs from various sources into a single PDF file. Supports merging submission PDFs, template PDFs, custom files, other merged PDFs, and PDFs from URLs. Merges the PDFs in the order provided.  Combining uses credits (4 per source PDF, plus 4 per unit of the combined PDF), even with a test API token or watermarked source PDFs. If your balance can't cover it, the API returns 402 and the combined submission waits in the `insufficient_credits` state until you add credits. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/). 
     # @param data [CombinePdfsData] 
     # @param [Hash] opts the optional parameters
     # @return [CreateCombinedSubmissionResponse]
@@ -216,7 +216,7 @@ end
     end
 
     # Merge submission PDFs, template PDFs, or custom files
-    # Combines multiple PDFs from various sources into a single PDF file. Supports merging submission PDFs, template PDFs, custom files, other merged PDFs, and PDFs from URLs. Merges the PDFs in the order provided. 
+    # Combines multiple PDFs from various sources into a single PDF file. Supports merging submission PDFs, template PDFs, custom files, other merged PDFs, and PDFs from URLs. Merges the PDFs in the order provided.  Combining uses credits (4 per source PDF, plus 4 per unit of the combined PDF), even with a test API token or watermarked source PDFs. If your balance can't cover it, the API returns 402 and the combined submission waits in the `insufficient_credits` state until you add credits. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/). 
     # @param data [CombinePdfsData] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(CreateCombinedSubmissionResponse, Integer, Hash)>] CreateCombinedSubmissionResponse data, response status code and response headers
@@ -1231,7 +1231,7 @@ end
     end
 
     # Generate a PDF
-    # Creates a PDF submission by filling in a template with data. Supports both synchronous (default) and asynchronous processing. Add the `wait=false` query parameter to return immediately.  See also: - [Customize the PDF Title and Filename](https://docspring.com/docs/api-guide/generate-pdfs/customize-pdf-title-and-filename/) - Set custom metadata - [Handling Truncated Text](https://docspring.com/docs/api-guide/generate-pdfs/handle-truncated-text/) - Handle text that doesn't fit in fields 
+    # Creates a PDF submission by filling in a template with data. Supports both synchronous (default) and asynchronous processing. Add the `wait=false` query parameter to return immediately.  Live PDFs use credits; test PDFs (`test: true`) are free and watermarked. If your balance can't cover a live PDF, the API returns 402 and the submission waits in the `insufficient_credits` state until you add credits. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).  See also: - [Customize the PDF Title and Filename](https://docspring.com/docs/api-guide/generate-pdfs/customize-pdf-title-and-filename/) - Set custom metadata - [Handling Truncated Text](https://docspring.com/docs/api-guide/generate-pdfs/handle-truncated-text/) - Handle text that doesn't fit in fields 
     # @param template_id [String] 
     # @param submission [CreatePdfSubmissionData] 
     # @param [Hash] opts the optional parameters
@@ -1243,7 +1243,7 @@ end
     end
 
     # Generate a PDF
-    # Creates a PDF submission by filling in a template with data. Supports both synchronous (default) and asynchronous processing. Add the &#x60;wait&#x3D;false&#x60; query parameter to return immediately.  See also: - [Customize the PDF Title and Filename](https://docspring.com/docs/api-guide/generate-pdfs/customize-pdf-title-and-filename/) - Set custom metadata - [Handling Truncated Text](https://docspring.com/docs/api-guide/generate-pdfs/handle-truncated-text/) - Handle text that doesn&#39;t fit in fields 
+    # Creates a PDF submission by filling in a template with data. Supports both synchronous (default) and asynchronous processing. Add the &#x60;wait&#x3D;false&#x60; query parameter to return immediately.  Live PDFs use credits; test PDFs (&#x60;test: true&#x60;) are free and watermarked. If your balance can&#39;t cover a live PDF, the API returns 402 and the submission waits in the &#x60;insufficient_credits&#x60; state until you add credits. See [Credits &amp; Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).  See also: - [Customize the PDF Title and Filename](https://docspring.com/docs/api-guide/generate-pdfs/customize-pdf-title-and-filename/) - Set custom metadata - [Handling Truncated Text](https://docspring.com/docs/api-guide/generate-pdfs/handle-truncated-text/) - Handle text that doesn&#39;t fit in fields 
     # @param template_id [String] 
     # @param submission [CreatePdfSubmissionData] 
     # @param [Hash] opts the optional parameters
@@ -1371,7 +1371,7 @@ end
     end
 
     # Check the status of a combined submission (merged PDFs)
-    # Retrieves the details and status of a combined submission. Returns processing state, download URL (if processed), metadata, and information about any integrated actions (e.g., S3 uploads). 
+    # Retrieves the details and status of a combined submission. Returns processing state, download URL (if processed), metadata, and information about any integrated actions (e.g., S3 uploads).  `insufficient_credits` means the combined submission is waiting for credits and is processed once you add them. If it's still waiting after 30 days, it moves to `error`. 
     # @param combined_submission_id [String] 
     # @param [Hash] opts the optional parameters
     # @return [CombinedSubmission]
@@ -1381,7 +1381,7 @@ end
     end
 
     # Check the status of a combined submission (merged PDFs)
-    # Retrieves the details and status of a combined submission. Returns processing state, download URL (if processed), metadata, and information about any integrated actions (e.g., S3 uploads). 
+    # Retrieves the details and status of a combined submission. Returns processing state, download URL (if processed), metadata, and information about any integrated actions (e.g., S3 uploads).  &#x60;insufficient_credits&#x60; means the combined submission is waiting for credits and is processed once you add them. If it&#39;s still waiting after 30 days, it moves to &#x60;error&#x60;. 
     # @param combined_submission_id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(CombinedSubmission, Integer, Hash)>] CombinedSubmission data, response status code and response headers
@@ -1617,7 +1617,7 @@ end
     end
 
     # Check the status of a PDF
-    # Retrieves the details and status of a PDF submission. Returns processing state, download URL (if processed), metadata, submission data (optional), and information about any integrated actions. Use this to poll for completion when using asynchronous processing. 
+    # Retrieves the details and status of a PDF submission. Returns processing state, download URL (if processed), metadata, submission data (optional), and information about any integrated actions. Use this to poll for completion when using asynchronous processing.  `insufficient_credits` means the submission is waiting for credits and is processed once you add them. If it's still waiting after 30 days, it moves to `error`. 
     # @param submission_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :include_data 
@@ -1628,7 +1628,7 @@ end
     end
 
     # Check the status of a PDF
-    # Retrieves the details and status of a PDF submission. Returns processing state, download URL (if processed), metadata, submission data (optional), and information about any integrated actions. Use this to poll for completion when using asynchronous processing. 
+    # Retrieves the details and status of a PDF submission. Returns processing state, download URL (if processed), metadata, submission data (optional), and information about any integrated actions. Use this to poll for completion when using asynchronous processing.  &#x60;insufficient_credits&#x60; means the submission is waiting for credits and is processed once you add them. If it&#39;s still waiting after 30 days, it moves to &#x60;error&#x60;. 
     # @param submission_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :include_data 
@@ -1683,7 +1683,7 @@ end
     end
 
     # Check the status of a submission batch job
-    # Retrieves the status and results of a batch PDF generation job. Returns processing state, completion statistics, and optionally includes all individual submission details. Use this to poll for completion when using asynchronous batch processing. 
+    # Retrieves the status and results of a batch PDF generation job. Returns processing state, completion statistics, and optionally includes all individual submission details. Use this to poll for completion when using asynchronous batch processing.  Submissions waiting for credits are in the `insufficient_credits` state and count as pending, so the batch stays `pending` until you add credits or they stop waiting after 30 days. 
     # @param submission_batch_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :include_submissions 
@@ -1694,7 +1694,7 @@ end
     end
 
     # Check the status of a submission batch job
-    # Retrieves the status and results of a batch PDF generation job. Returns processing state, completion statistics, and optionally includes all individual submission details. Use this to poll for completion when using asynchronous batch processing. 
+    # Retrieves the status and results of a batch PDF generation job. Returns processing state, completion statistics, and optionally includes all individual submission details. Use this to poll for completion when using asynchronous batch processing.  Submissions waiting for credits are in the &#x60;insufficient_credits&#x60; state and count as pending, so the batch stays &#x60;pending&#x60; until you add credits or they stop waiting after 30 days. 
     # @param submission_batch_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :include_submissions 

data/lib/docspring/api_client.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 
@@ -33,7 +33,7 @@ module DocSpring
     # @option config [Configuration] Configuration for initializing the object, default to Configuration.default
     def initialize(config = Configuration.default)
       @config = config
-      @user_agent = "docspring-ruby-3.3.0"
+      @user_agent = "docspring-ruby-3.5.0"
       @default_headers = {
         'Content-Type' => 'application/json',
         'User-Agent' => @user_agent

data/lib/docspring/api_error.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 

data/lib/docspring/configuration.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 

data/lib/docspring/models/add_fields_data.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 

data/lib/docspring/models/batch_generate_pdfs201_response.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 
@@ -25,6 +25,9 @@ module DocSpring
 
     attr_accessor :submissions
 
+    # `insufficient_credits` when the response is a 402.
+    attr_accessor :code
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -54,7 +57,8 @@ module DocSpring
         :'error' => :'error',
         :'errors' => :'errors',
         :'submission_batch' => :'submission_batch',
-        :'submissions' => :'submissions'
+        :'submissions' => :'submissions',
+        :'code' => :'code'
       }
     end
 
@@ -75,7 +79,8 @@ module DocSpring
         :'error' => :'String',
         :'errors' => :'Array<String>',
         :'submission_batch' => :'SubmissionBatch',
-        :'submissions' => :'Array<Object>'
+        :'submissions' => :'Array<Object>',
+        :'code' => :'String'
       }
     end
 
@@ -130,6 +135,10 @@ module DocSpring
       else
         self.submissions = nil
       end
+
+      if attributes.key?(:'code')
+        self.code = attributes[:'code']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -204,7 +213,8 @@ module DocSpring
           error == o.error &&
           errors == o.errors &&
           submission_batch == o.submission_batch &&
-          submissions == o.submissions
+          submissions == o.submissions &&
+          code == o.code
     end
 
     # @see the `==` method
@@ -216,7 +226,7 @@ module DocSpring
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [status, error, errors, submission_batch, submissions].hash
+      [status, error, errors, submission_batch, submissions, code].hash
     end
 
     # Builds the object from hash

data/lib/docspring/models/combine_pdfs_data.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 
@@ -26,7 +26,7 @@ module DocSpring
 
     attr_accessor :source_pdfs
 
-    # Deprecated, and has no effect. A combined PDF is a test or live document because of its source PDFs.
+    # Deprecated, and has no effect. Combining always uses credits, even with a test API token or watermarked source PDFs.
     attr_accessor :test
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/docspring/models/combined_submission.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 
@@ -273,7 +273,7 @@ module DocSpring
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @state.nil?
-      state_validator = EnumAttributeValidator.new('String', ["pending", "processed", "error"])
+      state_validator = EnumAttributeValidator.new('String', ["pending", "processed", "error", "insufficient_credits"])
       return false unless state_validator.valid?(@state)
       return false if @expired.nil?
       return false if @submission_ids.nil?
@@ -286,7 +286,7 @@ module DocSpring
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] state Object to be assigned
     def state=(state)
-      validator = EnumAttributeValidator.new('String', ["pending", "processed", "error"])
+      validator = EnumAttributeValidator.new('String', ["pending", "processed", "error", "insufficient_credits"])
       # build_from_hash accepts enum values this client doesn't know about yet
       unless defined?(@_skip_enum_validation) || validator.valid?(state)
         fail ArgumentError, "invalid value for \"state\", must be one of #{validator.allowable_values}."

data/lib/docspring/models/combined_submission_action.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 

data/lib/docspring/models/copy_template_options.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 

data/lib/docspring/models/create_combined_submission_response.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 
@@ -19,8 +19,13 @@ module DocSpring
 
     attr_accessor :combined_submission
 
+    attr_accessor :error
+
     attr_accessor :errors
 
+    # `insufficient_credits` when the response is a 402.
+    attr_accessor :code
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -48,7 +53,9 @@ module DocSpring
       {
         :'status' => :'status',
         :'combined_submission' => :'combined_submission',
-        :'errors' => :'errors'
+        :'error' => :'error',
+        :'errors' => :'errors',
+        :'code' => :'code'
       }
     end
 
@@ -67,7 +74,9 @@ module DocSpring
       {
         :'status' => :'String',
         :'combined_submission' => :'CombinedSubmission',
-        :'errors' => :'Array<String>'
+        :'error' => :'String',
+        :'errors' => :'Array<String>',
+        :'code' => :'String'
       }
     end
 
@@ -105,11 +114,19 @@ module DocSpring
         self.combined_submission = nil
       end
 
+      if attributes.key?(:'error')
+        self.error = attributes[:'error']
+      end
+
       if attributes.key?(:'errors')
         if (value = attributes[:'errors']).is_a?(Array)
           self.errors = value
         end
       end
+
+      if attributes.key?(:'code')
+        self.code = attributes[:'code']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -167,7 +184,9 @@ module DocSpring
       self.class == o.class &&
           status == o.status &&
           combined_submission == o.combined_submission &&
-          errors == o.errors
+          error == o.error &&
+          errors == o.errors &&
+          code == o.code
     end
 
     # @see the `==` method
@@ -179,7 +198,7 @@ module DocSpring
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [status, combined_submission, errors].hash
+      [status, combined_submission, error, errors, code].hash
     end
 
     # Builds the object from hash

data/lib/docspring/models/create_custom_file_data.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 

data/lib/docspring/models/create_custom_file_response.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1
 
@@ -19,6 +19,8 @@ module DocSpring
 
     attr_accessor :custom_file
 
+    attr_accessor :error
+
     attr_accessor :errors
 
     class EnumAttributeValidator
@@ -48,6 +50,7 @@ module DocSpring
       {
         :'status' => :'status',
         :'custom_file' => :'custom_file',
+        :'error' => :'error',
         :'errors' => :'errors'
       }
     end
@@ -67,6 +70,7 @@ module DocSpring
       {
         :'status' => :'String',
         :'custom_file' => :'CustomFile',
+        :'error' => :'String',
         :'errors' => :'Array<String>'
       }
     end
@@ -105,6 +109,10 @@ module DocSpring
         self.custom_file = nil
       end
 
+      if attributes.key?(:'error')
+        self.error = attributes[:'error']
+      end
+
       if attributes.key?(:'errors')
         if (value = attributes[:'errors']).is_a?(Array)
           self.errors = value
@@ -167,6 +175,7 @@ module DocSpring
       self.class == o.class &&
           status == o.status &&
           custom_file == o.custom_file &&
+          error == o.error &&
           errors == o.errors
     end
 
@@ -179,7 +188,7 @@ module DocSpring
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [status, custom_file, errors].hash
+      [status, custom_file, error, errors].hash
     end
 
     # Builds the object from hash

data/lib/docspring/models/create_folder_data.rb

@@ -1,7 +1,7 @@
 =begin
 #DocSpring API
 
-#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+#Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
 
 The version of the OpenAPI document: v1