docspring 4.1.0 → 4.3.0

data/lib/docspring/models/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 fill PDF forms, generate PDFs and Word documents from HTML or Word templates, merge PDFs, and request legally binding e-signatures.
 
 The version of the OpenAPI document: v2
 
@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module DocSpring
-  # Data submitted to a template, and the PDF generated from it.
+  # Data submitted to a template, and the files generated from it (a PDF, a Word document, an OpenDocument file, or more than one of them).
   class Submission < ApiModelBase
     # The submission's ID.
     attr_accessor :id
@@ -22,7 +22,7 @@ module DocSpring
     # Null once the template has been permanently deleted.
     attr_accessor :template_id
 
-    # The template's type: `pdf` or `html`.
+    # The template's type: `pdf`, `html` or `docx`.
     attr_accessor :template_type
 
     # The published version of the template the submission used. Null for the draft.
@@ -34,7 +34,7 @@ module DocSpring
     # `api`: created with the API. `web`: a web form. `reprocess`: a copy of another submission, made to generate its PDF again.
     attr_accessor :source
 
-    # `pending` until the PDF has been generated, then `processed`. `waiting_for_signature_requests` until every signature request is completed. `insufficient_credits`: waiting for credits; `error_message` says whether the PDF is generated once you add them. `account_suspended`: waiting for the account to be reactivated, for up to 30 days. Waiting ends in `error` if it's discarded or takes over 30 days. Every other state is final, with no PDF: `invalid_data` (the data doesn't match the template's fields: see `data_errors`), `declined` (a signature request was declined), and the states where generating the PDF failed, which have an `error_message`: `syntax_error` (a mistake in an HTML template's Liquid or SCSS), `image_download_failed` or `image_processing_failed` (an image in the data or the template couldn't be downloaded or read) and `error` (anything else). Older submissions can also be `license_revoked` or `accidental`.
+    # `pending` until the files have been generated, then `processed`. `waiting_for_signature_requests` until every signature request is completed. `insufficient_credits`: waiting for credits; `error_message` says whether the files are generated once you add them. `account_suspended`: waiting for the account to be reactivated, for up to 30 days. Waiting ends in `error` if it's discarded or takes over 30 days. Every other state is final, with no files: `invalid_data` (the data doesn't match the template's fields: see `data_errors`), `declined` (a signature request was declined), and the states where generating the files failed, which have an `error_message`: `syntax_error` (a mistake in an HTML template's Liquid or SCSS, or in a Word template's tags), `image_download_failed` or `image_processing_failed` (an image in the data or the template couldn't be downloaded or read) and `error` (anything else). Older submissions can also be `license_revoked` or `accidental`.
     attr_accessor :state
 
     # Test PDFs have a watermark and are free. Live PDFs use credits. Submissions made with a test API token are always test submissions.
@@ -43,7 +43,7 @@ module DocSpring
     # `true` keeps the PDF's text and check fields fillable, and `false` flattens every field. Left out, the template decides: its `editable_submissions` setting, or each field's own Editable option. A response shows the template's setting when the request left this out. Can't be `true` with `signature_requests`.
     attr_accessor :editable
 
-    # The submission's data, with the values entered in completed signature requests. Lists leave it out (null) unless you pass `include_data=true`. Empty once the submission has expired.
+    # The submission's data, with the values entered in completed signature requests. Empty once the submission has expired. Null in a batch's submissions unless you pass `include_data=true`, and in the events of a webhook that leaves out submission data.
     attr_accessor :data
 
     # Why the data doesn't match the template's fields, when `state` is `invalid_data`: the same details as the 422 response that recorded it, with pointers into the request that created the submission (`/data/name`). Cleared once the submission has expired.
@@ -52,30 +52,12 @@ module DocSpring
     # Why the PDF couldn't be generated, when `state` is `error`.
     attr_accessor :error_message
 
-    # Your own data about the submission, such as an ID from your app. It isn't printed on the PDF.
+    # Your own data about the submission, such as an ID from your app. It isn't printed on the PDF. Two keys also change the PDF: `pdf_filename` names its file (`files.pdf.filename`, and its download), and `pdf_title` is its title in the PDF's document properties (and an HTML template's `<title>`, unless its HTML has one). Without `pdf_title`, the title is the template's name. In `pdf_filename`, a `.pdf` ending is removed, each run of characters other than letters, digits, `-`, `_` and `.` becomes one `_`, and the first 128 characters are kept, then `.pdf` is added. Without it, the file is named after the submission's ID (`sub_1234567890abcdef01.pdf`).
     attr_accessor :metadata
 
-    # Whether the PDF needs a password to open (`password`).
-    attr_accessor :has_password
-
-    # The people asked to sign the submission (and fill in their fields), in order.
-    attr_accessor :signature_requests
-
-    # The uploads of the submission's PDF to your storage (account integrations).
-    attr_accessor :actions
-
-    # The text of each field that didn't fit in it, by field name. Left out (null) with `data`, and empty once the submission has expired.
-    attr_accessor :truncated_text
-
-    # What the submission makes: `pdf`, and `png` (an image of each page of the PDF, up to 100 pages) when you ask for it. Default `["pdf"]`. POST /submissions/{submission_id}/generate_files adds `png` to a processed submission.
-    attr_accessor :output_formats
-
-    # The generated files: `pdf` once the submission has been processed, `png` (the images of the PDF's pages, when `output_formats` has it: `files.png.pages[0]` is page 1), `audit_trail` once its signature requests are completed, and `preview` once a preview PDF has been generated. Empty once the submission has expired.
+    # The generated files: `pdf`, `docx` and `odt` (by `output_formats`) once the submission has been processed, `png` (the images of the PDF's pages, when `output_formats` has it: `files.png.pages[0]` is page 1), `audit_trail` once its signature requests are completed, and `preview` once a preview PDF has been generated. Empty once the submission has expired.
     attr_accessor :files
 
-    # When the preview PDF was generated. Null if there is no preview.
-    attr_accessor :preview_generated_at
-
     # An expired submission's data, metadata, password and PDF have been deleted.
     attr_accessor :expired
 
@@ -91,6 +73,24 @@ module DocSpring
     # When the submission was last updated.
     attr_accessor :updated_at
 
+    # Whether the PDF needs a password to open (`password`).
+    attr_accessor :has_password
+
+    # The people asked to sign the submission (and fill in their fields), in order.
+    attr_accessor :signature_requests
+
+    # The uploads of the submission's PDF to your storage (account integrations).
+    attr_accessor :actions
+
+    # The text of each field that didn't fit in it, by field name. Left out (null) with `data`, and empty once the submission has expired.
+    attr_accessor :truncated_text
+
+    # What the submission makes: `pdf`, `docx` (a Word document, from a Word template), `odt` (an OpenDocument file, the format LibreOffice uses, converted from a Word template's Word document), and `png` (an image of each page of the PDF, up to 100 pages, which adds `pdf`) when you ask for it. Default `["pdf"]`, or a Word template's `output_format`. POST /submissions/{submission_id}/generate_files adds `png`, and a Word template's submission's `pdf`, `docx` or `odt`, to a processed submission.
+    attr_accessor :output_formats
+
+    # When the preview PDF was generated. Null if there is no preview.
+    attr_accessor :preview_generated_at
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -129,18 +129,18 @@ module DocSpring
         :'data_errors' => :'data_errors',
         :'error_message' => :'error_message',
         :'metadata' => :'metadata',
-        :'has_password' => :'has_password',
-        :'signature_requests' => :'signature_requests',
-        :'actions' => :'actions',
-        :'truncated_text' => :'truncated_text',
-        :'output_formats' => :'output_formats',
         :'files' => :'files',
-        :'preview_generated_at' => :'preview_generated_at',
         :'expired' => :'expired',
         :'expires_at' => :'expires_at',
         :'processed_at' => :'processed_at',
         :'created_at' => :'created_at',
-        :'updated_at' => :'updated_at'
+        :'updated_at' => :'updated_at',
+        :'has_password' => :'has_password',
+        :'signature_requests' => :'signature_requests',
+        :'actions' => :'actions',
+        :'truncated_text' => :'truncated_text',
+        :'output_formats' => :'output_formats',
+        :'preview_generated_at' => :'preview_generated_at'
       }
     end
 
@@ -170,18 +170,18 @@ module DocSpring
         :'data_errors' => :'Array<ErrorDetail>',
         :'error_message' => :'String',
         :'metadata' => :'Hash<String, Object>',
-        :'has_password' => :'Boolean',
-        :'signature_requests' => :'Array<SignatureRequest>',
-        :'actions' => :'Array<SubmissionAction>',
-        :'truncated_text' => :'Hash<String, Array<String>>',
-        :'output_formats' => :'Array<OutputFormat>',
         :'files' => :'SubmissionFiles',
-        :'preview_generated_at' => :'Time',
         :'expired' => :'Boolean',
         :'expires_at' => :'Time',
         :'processed_at' => :'Time',
         :'created_at' => :'Time',
-        :'updated_at' => :'Time'
+        :'updated_at' => :'Time',
+        :'has_password' => :'Boolean',
+        :'signature_requests' => :'Array<SignatureRequest>',
+        :'actions' => :'Array<SubmissionAction>',
+        :'truncated_text' => :'Hash<String, Array<String>>',
+        :'output_formats' => :'Array<OutputFormat>',
+        :'preview_generated_at' => :'Time'
       }
     end
 
@@ -193,10 +193,10 @@ module DocSpring
         :'batch_id',
         :'data',
         :'error_message',
-        :'truncated_text',
-        :'preview_generated_at',
         :'expires_at',
         :'processed_at',
+        :'truncated_text',
+        :'preview_generated_at'
       ])
     end
 
@@ -310,6 +310,42 @@ module DocSpring
         self.metadata = nil
       end
 
+      if attributes.key?(:'files')
+        self.files = attributes[:'files']
+      else
+        self.files = nil
+      end
+
+      if attributes.key?(:'expired')
+        self.expired = attributes[:'expired']
+      else
+        self.expired = nil
+      end
+
+      if attributes.key?(:'expires_at')
+        self.expires_at = attributes[:'expires_at']
+      else
+        self.expires_at = nil
+      end
+
+      if attributes.key?(:'processed_at')
+        self.processed_at = attributes[:'processed_at']
+      else
+        self.processed_at = nil
+      end
+
+      if attributes.key?(:'created_at')
+        self.created_at = attributes[:'created_at']
+      else
+        self.created_at = nil
+      end
+
+      if attributes.key?(:'updated_at')
+        self.updated_at = attributes[:'updated_at']
+      else
+        self.updated_at = nil
+      end
+
       if attributes.key?(:'has_password')
         self.has_password = attributes[:'has_password']
       else
@@ -348,47 +384,11 @@ module DocSpring
         self.output_formats = nil
       end
 
-      if attributes.key?(:'files')
-        self.files = attributes[:'files']
-      else
-        self.files = nil
-      end
-
       if attributes.key?(:'preview_generated_at')
         self.preview_generated_at = attributes[:'preview_generated_at']
       else
         self.preview_generated_at = nil
       end
-
-      if attributes.key?(:'expired')
-        self.expired = attributes[:'expired']
-      else
-        self.expired = nil
-      end
-
-      if attributes.key?(:'expires_at')
-        self.expires_at = attributes[:'expires_at']
-      else
-        self.expires_at = nil
-      end
-
-      if attributes.key?(:'processed_at')
-        self.processed_at = attributes[:'processed_at']
-      else
-        self.processed_at = nil
-      end
-
-      if attributes.key?(:'created_at')
-        self.created_at = attributes[:'created_at']
-      else
-        self.created_at = nil
-      end
-
-      if attributes.key?(:'updated_at')
-        self.updated_at = attributes[:'updated_at']
-      else
-        self.updated_at = nil
-      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -428,22 +428,6 @@ module DocSpring
         invalid_properties.push('invalid value for "metadata", metadata cannot be nil.')
       end
 
-      if @has_password.nil?
-        invalid_properties.push('invalid value for "has_password", has_password cannot be nil.')
-      end
-
-      if @signature_requests.nil?
-        invalid_properties.push('invalid value for "signature_requests", signature_requests cannot be nil.')
-      end
-
-      if @actions.nil?
-        invalid_properties.push('invalid value for "actions", actions cannot be nil.')
-      end
-
-      if @output_formats.nil?
-        invalid_properties.push('invalid value for "output_formats", output_formats cannot be nil.')
-      end
-
       if @files.nil?
         invalid_properties.push('invalid value for "files", files cannot be nil.')
       end
@@ -460,6 +444,22 @@ module DocSpring
         invalid_properties.push('invalid value for "updated_at", updated_at cannot be nil.')
       end
 
+      if @has_password.nil?
+        invalid_properties.push('invalid value for "has_password", has_password cannot be nil.')
+      end
+
+      if @signature_requests.nil?
+        invalid_properties.push('invalid value for "signature_requests", signature_requests cannot be nil.')
+      end
+
+      if @actions.nil?
+        invalid_properties.push('invalid value for "actions", actions cannot be nil.')
+      end
+
+      if @output_formats.nil?
+        invalid_properties.push('invalid value for "output_formats", output_formats cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -475,14 +475,14 @@ module DocSpring
       return false if @editable.nil?
       return false if @data_errors.nil?
       return false if @metadata.nil?
-      return false if @has_password.nil?
-      return false if @signature_requests.nil?
-      return false if @actions.nil?
-      return false if @output_formats.nil?
       return false if @files.nil?
       return false if @expired.nil?
       return false if @created_at.nil?
       return false if @updated_at.nil?
+      return false if @has_password.nil?
+      return false if @signature_requests.nil?
+      return false if @actions.nil?
+      return false if @output_formats.nil?
       true
     end
 
@@ -566,46 +566,6 @@ module DocSpring
       @metadata = metadata
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] has_password Value to be assigned
-    def has_password=(has_password)
-      if has_password.nil?
-        fail ArgumentError, 'has_password cannot be nil'
-      end
-
-      @has_password = has_password
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] signature_requests Value to be assigned
-    def signature_requests=(signature_requests)
-      if signature_requests.nil?
-        fail ArgumentError, 'signature_requests cannot be nil'
-      end
-
-      @signature_requests = signature_requests
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] actions Value to be assigned
-    def actions=(actions)
-      if actions.nil?
-        fail ArgumentError, 'actions cannot be nil'
-      end
-
-      @actions = actions
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] output_formats Value to be assigned
-    def output_formats=(output_formats)
-      if output_formats.nil?
-        fail ArgumentError, 'output_formats cannot be nil'
-      end
-
-      @output_formats = output_formats
-    end
-
     # Custom attribute writer method with validation
     # @param [Object] files Value to be assigned
     def files=(files)
@@ -646,6 +606,46 @@ module DocSpring
       @updated_at = updated_at
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] has_password Value to be assigned
+    def has_password=(has_password)
+      if has_password.nil?
+        fail ArgumentError, 'has_password cannot be nil'
+      end
+
+      @has_password = has_password
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] signature_requests Value to be assigned
+    def signature_requests=(signature_requests)
+      if signature_requests.nil?
+        fail ArgumentError, 'signature_requests cannot be nil'
+      end
+
+      @signature_requests = signature_requests
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] actions Value to be assigned
+    def actions=(actions)
+      if actions.nil?
+        fail ArgumentError, 'actions cannot be nil'
+      end
+
+      @actions = actions
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] output_formats Value to be assigned
+    def output_formats=(output_formats)
+      if output_formats.nil?
+        fail ArgumentError, 'output_formats cannot be nil'
+      end
+
+      @output_formats = output_formats
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -664,18 +664,18 @@ module DocSpring
           data_errors == o.data_errors &&
           error_message == o.error_message &&
           metadata == o.metadata &&
-          has_password == o.has_password &&
-          signature_requests == o.signature_requests &&
-          actions == o.actions &&
-          truncated_text == o.truncated_text &&
-          output_formats == o.output_formats &&
           files == o.files &&
-          preview_generated_at == o.preview_generated_at &&
           expired == o.expired &&
           expires_at == o.expires_at &&
           processed_at == o.processed_at &&
           created_at == o.created_at &&
-          updated_at == o.updated_at
+          updated_at == o.updated_at &&
+          has_password == o.has_password &&
+          signature_requests == o.signature_requests &&
+          actions == o.actions &&
+          truncated_text == o.truncated_text &&
+          output_formats == o.output_formats &&
+          preview_generated_at == o.preview_generated_at
     end
 
     # @see the `==` method
@@ -687,7 +687,7 @@ module DocSpring
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, template_id, template_type, template_version, batch_id, source, state, test, editable, data, data_errors, error_message, metadata, has_password, signature_requests, actions, truncated_text, output_formats, files, preview_generated_at, expired, expires_at, processed_at, created_at, updated_at].hash
+      [id, template_id, template_type, template_version, batch_id, source, state, test, editable, data, data_errors, error_message, metadata, files, expired, expires_at, processed_at, created_at, updated_at, has_password, signature_requests, actions, truncated_text, output_formats, preview_generated_at].hash
     end
 
     # Builds the object from hash

data/lib/docspring/models/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 fill PDF forms, generate PDFs and Word documents from HTML or Word templates, merge PDFs, and request legally binding e-signatures.
 
 The version of the OpenAPI document: v2
 

data/lib/docspring/models/submission_action_state.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 fill PDF forms, generate PDFs and Word documents from HTML or Word templates, merge PDFs, and request legally binding e-signatures.
 
 The version of the OpenAPI document: v2
 

data/lib/docspring/models/submission_action_type.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 fill PDF forms, generate PDFs and Word documents from HTML or Word templates, merge PDFs, and request legally binding e-signatures.
 
 The version of the OpenAPI document: v2
 

data/lib/docspring/models/submission_batch.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 fill PDF forms, generate PDFs and Word documents from HTML or Word templates, merge PDFs, and request legally binding e-signatures.
 
 The version of the OpenAPI document: v2
 
@@ -14,12 +14,12 @@ require 'date'
 require 'time'
 
 module DocSpring
-  # Submissions created together in one request. Their PDFs are only generated when every submission in the batch is valid.
+  # Submissions created together in one request. Their files are only generated when every submission in the batch is valid.
   class SubmissionBatch < ApiModelBase
     # The batch's ID.
     attr_accessor :id
 
-    # `pending` while the PDFs are being generated, then `processed`. `error` as soon as a submission fails, while the others can still be pending: the batch has finished once `processed_at` is set.
+    # `pending` while the files are being generated, then `processed`. `error` as soon as a submission fails, while the others can still be pending: the batch has finished once `processed_at` is set.
     attr_accessor :state
 
     # Your own data about the batch, such as an ID from your app.
@@ -28,10 +28,10 @@ module DocSpring
     # The number of submissions in the request.
     attr_accessor :total_count
 
-    # The submissions whose PDFs haven't been generated yet.
+    # The submissions whose files haven't been generated yet.
     attr_accessor :pending_count
 
-    # The submissions that were invalid or whose PDFs couldn't be generated.
+    # The submissions that were invalid or whose files couldn't be generated.
     attr_accessor :error_count
 
     # The percentage of the batch's submissions that have finished, from 0 to 100.

data/lib/docspring/models/submission_batch_state.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 fill PDF forms, generate PDFs and Word documents from HTML or Word templates, merge PDFs, and request legally binding e-signatures.
 
 The version of the OpenAPI document: v2
 

data/lib/docspring/models/submission_files.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 fill PDF forms, generate PDFs and Word documents from HTML or Word templates, merge PDFs, and request legally binding e-signatures.
 
 The version of the OpenAPI document: v2
 
@@ -25,6 +25,12 @@ module DocSpring
     # The preview PDF from POST /submissions/{submission_id}/generate_preview, such as for a submission still waiting for its signature requests.
     attr_accessor :preview
 
+    # The Word document of a Word template's submission, when the submission makes one (`output_formats`).
+    attr_accessor :docx
+
+    # The OpenDocument file (.odt, the format LibreOffice uses) of a Word template's submission, converted from its Word document, when the submission makes one (`output_formats`).
+    attr_accessor :odt
+
     attr_accessor :png
 
     # Attribute mapping from ruby-style variable name to JSON key.
@@ -33,6 +39,8 @@ module DocSpring
         :'pdf' => :'pdf',
         :'audit_trail' => :'audit_trail',
         :'preview' => :'preview',
+        :'docx' => :'docx',
+        :'odt' => :'odt',
         :'png' => :'png'
       }
     end
@@ -53,6 +61,8 @@ module DocSpring
         :'pdf' => :'GeneratedFile',
         :'audit_trail' => :'GeneratedFile',
         :'preview' => :'GeneratedFile',
+        :'docx' => :'GeneratedFile',
+        :'odt' => :'GeneratedFile',
         :'png' => :'PageImages'
       }
     end
@@ -101,6 +111,14 @@ module DocSpring
         self.preview = attributes[:'preview']
       end
 
+      if attributes.key?(:'docx')
+        self.docx = attributes[:'docx']
+      end
+
+      if attributes.key?(:'odt')
+        self.odt = attributes[:'odt']
+      end
+
       if attributes.key?(:'png')
         self.png = attributes[:'png']
       end
@@ -129,6 +147,8 @@ module DocSpring
           pdf == o.pdf &&
           audit_trail == o.audit_trail &&
           preview == o.preview &&
+          docx == o.docx &&
+          odt == o.odt &&
           png == o.png
     end
 
@@ -141,7 +161,7 @@ module DocSpring
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [pdf, audit_trail, preview, png].hash
+      [pdf, audit_trail, preview, docx, odt, png].hash
     end
 
     # Builds the object from hash

data/lib/docspring/models/submission_input.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 fill PDF forms, generate PDFs and Word documents from HTML or Word templates, merge PDFs, and request legally binding e-signatures.
 
 The version of the OpenAPI document: v2
 
@@ -22,16 +22,16 @@ module DocSpring
     # `true` keeps the PDF's text and check fields fillable, and `false` flattens every field. Left out, the template decides: its `editable_submissions` setting, or each field's own Editable option. A response shows the template's setting when the request left this out. Can't be `true` with `signature_requests`.
     attr_accessor :editable
 
-    # The values of the template's fields, by field name. Required for a PDF template.
+    # The values of the template's fields, by field name. Required for PDF and Word templates.
     attr_accessor :data
 
-    # Your own data about the submission, such as an ID from your app. It isn't printed on the PDF.
+    # Your own data about the submission, such as an ID from your app. It isn't printed on the PDF. Two keys also change the PDF: `pdf_filename` names its file (`files.pdf.filename`, and its download), and `pdf_title` is its title in the PDF's document properties (and an HTML template's `<title>`, unless its HTML has one). Without `pdf_title`, the title is the template's name. In `pdf_filename`, a `.pdf` ending is removed, each run of characters other than letters, digits, `-`, `_` and `.` becomes one `_`, and the first 128 characters are kept, then `.pdf` is added. Without it, the file is named after the submission's ID (`sub_1234567890abcdef01.pdf`).
     attr_accessor :metadata
 
-    # A password that the PDF needs to be opened with. It's never returned; `has_password` says if it's set.
+    # A password that the PDF needs to be opened with. It's never returned; `has_password` says if it's set. Word documents and OpenDocument files can't be password-protected, so a submission with a password can't make them.
     attr_accessor :password
 
-    # What the submission makes: `pdf`, and `png` (an image of each page of the PDF, up to 100 pages) when you ask for it. Default `["pdf"]`. POST /submissions/{submission_id}/generate_files adds `png` to a processed submission.
+    # What the submission makes: `pdf`, `docx` (a Word document, from a Word template), `odt` (an OpenDocument file, the format LibreOffice uses, converted from a Word template's Word document), and `png` (an image of each page of the PDF, up to 100 pages, which adds `pdf`) when you ask for it. Default `["pdf"]`, or a Word template's `output_format`. POST /submissions/{submission_id}/generate_files adds `png`, and a Word template's submission's `pdf`, `docx` or `odt`, to a processed submission.
     attr_accessor :output_formats
 
     # Seconds after the PDF is generated until the submission expires, up to 10 years (315360000). Default the template's expiration setting. A submission that isn't processed, such as one with invalid data, is kept for at least 48 hours.
@@ -43,7 +43,7 @@ module DocSpring
     # For an HTML template, HTML to use instead of the template's.
     attr_accessor :html
 
-    # For an HTML template, CSS to use instead of the template's.
+    # For an HTML template, SCSS (plain CSS works too) added after the template's styles, on the page and in its header and footer. It doesn't replace them: its rules come later, so they win over the template's rules of the same specificity.
     attr_accessor :css
 
     # The submission's template. Default the batch's `template_id`.

data/lib/docspring/models/submission_list.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 fill PDF forms, generate PDFs and Word documents from HTML or Word templates, merge PDFs, and request legally binding e-signatures.
 
 The version of the OpenAPI document: v2
 
@@ -43,7 +43,7 @@ module DocSpring
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'data' => :'Array<Submission>',
+        :'data' => :'Array<SubmissionSummary>',
         :'next_cursor' => :'String'
       }
     end

data/lib/docspring/models/submission_source.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 fill PDF forms, generate PDFs and Word documents from HTML or Word templates, merge PDFs, and request legally binding e-signatures.
 
 The version of the OpenAPI document: v2