docspring 4.1.0 → 4.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d124a4eb39c1edc1b535fe60c6027af58866731018f574e3b58e9c9e658081bb
-  data.tar.gz: 4a365cf441b2b34c9a841059ea647b0c8ce0e2680183ddc229a7f6482e4af8e1
+  metadata.gz: e997a9a92a04e7b8eaeb759762e39be31bb36af02db1fa61f65637c984f6e88f
+  data.tar.gz: 50b74a6a63e254b540af52e18e7c1b32275e4069ed1e71ceb3edea81824532be
 SHA512:
-  metadata.gz: e565b0c650ff70a2e1791e82c6be2b9afe21c0edce375b77c17cc92f98954b71e5ff6fa473d8df181a17687e9e2cfc8b4ddffa34dbc7e103f16366eb74936e88
-  data.tar.gz: cd338cfa5caed832ebcfe25aedab0582c2e004050bab456d3b2d5b7f1e43001644d44a4a6d16be5d942f600f4a2a203fd41e83331b6ec2e7ea82f8badfe42aa2
+  metadata.gz: 1a60aa7099efbb3871f29e3f4ea86c7095fa3495fb62c3f25bdc23c0640425291626c173b923f5baf07126f304ead67c79c970a99ce6244405c3150947b942e3
+  data.tar.gz: 6ef873b90d45b59c89829065d1d70b225c30e7feb116698a545347c2563580f9fe44fa0fde50378b8bf87052c0ba109d017fd11c52d200dcf55000d57d4f7649

data/.openapi-generator/FILES

@@ -29,6 +29,7 @@ docs/CreateSignatureRequestEventRequest.md
 docs/CreateSignatureRequestTokenRequest.md
 docs/CreateSubmissionBatchRequest.md
 docs/CreateSubmissionRequest.md
+docs/CreateTemplatePreviewRequest.md
 docs/CreateTemplateRequest.md
 docs/CreateWebhookRequest.md
 docs/CustomFile.md
@@ -110,6 +111,7 @@ docs/SubmissionList.md
 docs/SubmissionSource.md
 docs/SubmissionSourcePdf.md
 docs/SubmissionState.md
+docs/SubmissionSummary.md
 docs/SubmissionValidation.md
 docs/Template.md
 docs/TemplateActor.md
@@ -120,6 +122,7 @@ docs/TemplateDiff.md
 docs/TemplateDiffSummary.md
 docs/TemplateDocument.md
 docs/TemplateDocumentState.md
+docs/TemplateDocumentSummary.md
 docs/TemplateFieldChange.md
 docs/TemplateFieldChanges.md
 docs/TemplateFieldDependency.md
@@ -140,6 +143,8 @@ docs/TemplatePageFieldsStatus.md
 docs/TemplatePageImageStatus.md
 docs/TemplatePageImages.md
 docs/TemplatePageProcessingStatus.md
+docs/TemplatePreview.md
+docs/TemplatePreviewState.md
 docs/TemplateSourcePdf.md
 docs/TemplateSummary.md
 docs/TemplateSummaryList.md
@@ -193,6 +198,7 @@ lib/docspring/models/create_signature_request_event_request.rb
 lib/docspring/models/create_signature_request_token_request.rb
 lib/docspring/models/create_submission_batch_request.rb
 lib/docspring/models/create_submission_request.rb
+lib/docspring/models/create_template_preview_request.rb
 lib/docspring/models/create_template_request.rb
 lib/docspring/models/create_webhook_request.rb
 lib/docspring/models/custom_file.rb
@@ -274,6 +280,7 @@ lib/docspring/models/submission_list.rb
 lib/docspring/models/submission_source.rb
 lib/docspring/models/submission_source_pdf.rb
 lib/docspring/models/submission_state.rb
+lib/docspring/models/submission_summary.rb
 lib/docspring/models/submission_validation.rb
 lib/docspring/models/template.rb
 lib/docspring/models/template_actor.rb
@@ -284,6 +291,7 @@ lib/docspring/models/template_diff.rb
 lib/docspring/models/template_diff_summary.rb
 lib/docspring/models/template_document.rb
 lib/docspring/models/template_document_state.rb
+lib/docspring/models/template_document_summary.rb
 lib/docspring/models/template_field_change.rb
 lib/docspring/models/template_field_changes.rb
 lib/docspring/models/template_field_dependency.rb
@@ -304,6 +312,8 @@ lib/docspring/models/template_page_fields_status.rb
 lib/docspring/models/template_page_image_status.rb
 lib/docspring/models/template_page_images.rb
 lib/docspring/models/template_page_processing_status.rb
+lib/docspring/models/template_preview.rb
+lib/docspring/models/template_preview_state.rb
 lib/docspring/models/template_source_pdf.rb
 lib/docspring/models/template_summary.rb
 lib/docspring/models/template_summary_list.rb
@@ -351,6 +361,7 @@ spec/models/create_signature_request_event_request_spec.rb
 spec/models/create_signature_request_token_request_spec.rb
 spec/models/create_submission_batch_request_spec.rb
 spec/models/create_submission_request_spec.rb
+spec/models/create_template_preview_request_spec.rb
 spec/models/create_template_request_spec.rb
 spec/models/create_webhook_request_spec.rb
 spec/models/custom_file_list_spec.rb
@@ -432,6 +443,7 @@ spec/models/submission_source_pdf_spec.rb
 spec/models/submission_source_spec.rb
 spec/models/submission_spec.rb
 spec/models/submission_state_spec.rb
+spec/models/submission_summary_spec.rb
 spec/models/submission_validation_spec.rb
 spec/models/template_actor_spec.rb
 spec/models/template_actor_type_spec.rb
@@ -441,6 +453,7 @@ spec/models/template_diff_spec.rb
 spec/models/template_diff_summary_spec.rb
 spec/models/template_document_spec.rb
 spec/models/template_document_state_spec.rb
+spec/models/template_document_summary_spec.rb
 spec/models/template_field_change_spec.rb
 spec/models/template_field_changes_spec.rb
 spec/models/template_field_dependency_action_spec.rb
@@ -461,6 +474,8 @@ spec/models/template_page_fields_status_spec.rb
 spec/models/template_page_image_status_spec.rb
 spec/models/template_page_images_spec.rb
 spec/models/template_page_processing_status_spec.rb
+spec/models/template_preview_spec.rb
+spec/models/template_preview_state_spec.rb
 spec/models/template_source_pdf_spec.rb
 spec/models/template_spec.rb
 spec/models/template_summary_list_spec.rb

data/.travis.yml

@@ -8,4 +8,4 @@ script:
   - bundle install --path vendor/bundle
   - bundle exec rspec
   - gem build docspring.gemspec
-  - gem install ./docspring-4.1.0.gem
+  - gem install ./docspring-4.3.0.gem

data/AGENTS.md

@@ -69,8 +69,9 @@ keeps it.
   (https://docspring.com/docs/webhooks/overview/). A webhook created with API v2 sends events in API v2's format
   (version 4).
 - Verify each request's `X-DocSpring-Signature` header before acting on it: an HMAC-SHA256 of `{t}.{raw body}` with the
-  webhook's signing secret, computed over the raw body exactly as received
-  (https://docspring.com/docs/webhooks/verifying-signatures/).
+  webhook's signing secret, where `t` must be within 5 minutes
+  (https://docspring.com/docs/webhooks/verifying-signatures/). Pass the raw body exactly as received, not parsed JSON,
+  to `DocSpring.verify_webhook_signature(payload, signature_header, secret)`, which returns true or false.
 - No webhook is sent when a submission starts waiting for credits.
 
 ## Signature requests
@@ -89,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 leaves out a response field added to the API after this release. 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 leaves out a response field added to the API after this release. An enum value added after this release comes
+  back as the API sent it: handle values you don't recognize.

data/CHANGELOG.md

@@ -1,3 +1,70 @@
+### 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
+  (`parent_folder_id`, `path`), latest published version, whether it's `ready`, and its PDF's file name, state, error
+  and page count (`document`, a `TemplateDocumentSummary`). get_template returns its settings and the rest.
+- **BREAKING CHANGE**: list_submissions and list_template_submissions return `SubmissionSummary` instead of
+  `Submission`: without signature requests and uploads, with `data` only when you pass `include_data` (as before), and
+  with `files` only when you pass the new `include_files` (without the links to page images). get_submission returns the
+  whole submission.
+- New: the template webhook events (version 4) send the whole template, as get_template returns it, without its
+  `embed_edit_token`. They sent the settings without the rest.
+- New: list_submissions and list_template_submissions take a `state` filter: one state, such as `invalid_data` or
+  `error`.
+- New: get_template_model_code takes `just_types`, for the types alone, without the code that converts and checks JSON
+  (TypeScript, Ruby, Python, Java, C#, Elixir and Go: JavaScript and PHP code is the same either way).
+- New: create_submission, create_submission_batch and create_combined_pdf take an `Idempotency-Key` header. A request
+  repeated with the same key within 24 hours returns the first response and creates nothing. The same key with a
+  different request is a 422, and a repeat while the first request is still running is a 409.
+- New: create_template_preview and get_template_preview fill an HTML or PDF template's draft (or a published version)
+  with your data and return PNG images of its pages, not a PDF, so you can check how it prints before you publish it or
+  send live data. A preview creates no submission and uses no credits. Get the preview until its `state` is
+  `processed`. Previews are watermarked like test PDFs.
+- New: HTML templates' `html_escape_data` setting HTML-escapes the values they print (`{{ value }}`). It's on for new
+  templates and off for existing ones; `{{ value | raw }}` prints a value as it is.
+- New: `DocSpring.verify_webhook_signature(payload, signature_header, secret)` checks a webhook request's
+  `X-DocSpring-Signature` header. Pass it the request body exactly as it was received. It returns true or false, accepts
+  any `v1` that matches and rejects a timestamp more than 5 minutes old (`tolerance:` for another tolerance).
+- publish_template_version answers 409 when the draft hasn't changed since the latest published version, instead of
+  publishing a copy of it (code `conflict`). A template's first publish always works.
+- Every operation documents the 429 rate limit response (with `Retry-After`), and the creates that the sync hosts wait
+  for document their 504 (the record was saved: get it by the ID in the error).
+- Every optional field takes `null` in a submission's `data`, whatever its type, so model code that writes missing
+  values as null works. A null checkbox or group of fields (an object or a list) gets its defaults, as a missing key
+  does, and a null text, number, date, image or signature field prints blank, as before. Null in a required field is
+  still an error.
+- Query parameters and request body values that take a date and time (`created_after`, `created_before`) take a `Time`,
+  `DateTime` or `Date` as well as a string, sent as RFC 3339 (a `Date` as midnight UTC). They failed the request's
+  validation before.
+- Template and webhook names can be up to 512 characters, up from 255.
+
 ### 4.1.0 [October 27, 2026]
 
 - New: list_template_fields, add_template_fields, update_template_fields, remove_template_fields and

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    docspring (4.1.0)
+    docspring (4.3.0)
       logger
       typhoeus (~> 1.0, >= 1.0.1)
 
@@ -14,7 +14,7 @@ GEM
     coderay (1.1.3)
     date (3.6.0)
     diff-lcs (1.6.2)
-    ethon (0.18.0)
+    ethon (0.19.1)
       ffi (>= 1.15.0)
       logger
     ffi (1.17.4)
@@ -28,7 +28,7 @@ GEM
     ffi (1.17.4-x86_64-darwin)
     ffi (1.17.4-x86_64-linux-gnu)
     ffi (1.17.4-x86_64-linux-musl)
-    io-console (0.9.4)
+    io-console (0.9.5)
     jaro_winkler (1.5.6)
     logger (1.7.0)
     method_source (1.1.0)
@@ -74,8 +74,8 @@ GEM
       unicode-display_width (>= 1.4.0, < 1.6)
     ruby-progressbar (1.13.0)
     stringio (3.2.0)
-    typhoeus (1.6.0)
-      ethon (>= 0.18.0)
+    typhoeus (1.7.1)
+      ethon (>= 0.19.1, < 0.20.0)
     unicode-display_width (1.5.0)
 
 PLATFORMS
@@ -100,12 +100,13 @@ DEPENDENCIES
 
 CHECKSUMS
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  bundler (4.0.23) sha256=407ba8a1d928f412847f819aa5f8b6aef7c59fb51feb517112af8a165487287b
   byebug (13.0.0) sha256=d2263efe751941ca520fa29744b71972d39cbc41839496706f5d9b22e92ae05d
   coderay (1.1.3) sha256=dc530018a4684512f8f38143cd2a096c9f02a1fc2459edcfe534787a7fc77d4b
   date (3.6.0) sha256=18ac945c4e24ebd93534f8eab8c2fd8c5604b3e977105b3798d62a1e8d27b580
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
-  docspring (4.1.0)
-  ethon (0.18.0) sha256=b598afc9f30448cb068b850714b7d6948e941476095d04f90a4ac65b8d6efcb2
+  docspring (4.3.0)
+  ethon (0.19.1) sha256=f309dec67cfdefaf96b3d1ee0ed4f186eac518f131340f607bb3df3b4e13ddc4
   ffi (1.17.4) sha256=bcd1642e06f0d16fc9e09ac6d49c3a7298b9789bcb58127302f934e437d60acf
   ffi (1.17.4-aarch64-linux-gnu) sha256=b208f06f91ffd8f5e1193da3cae3d2ccfc27fc36fba577baf698d26d91c080df
   ffi (1.17.4-aarch64-linux-musl) sha256=9286b7a615f2676245283aef0a0a3b475ae3aae2bb5448baace630bb77b91f39
@@ -117,7 +118,7 @@ CHECKSUMS
   ffi (1.17.4-x86_64-darwin) sha256=aa70390523cf3235096cf64962b709b4cfbd5c082a2cb2ae714eb0fe2ccda496
   ffi (1.17.4-x86_64-linux-gnu) sha256=9d3db14c2eae074b382fa9c083fe95aec6e0a1451da249eab096c34002bc752d
   ffi (1.17.4-x86_64-linux-musl) sha256=3fdf9888483de005f8ef8d1cf2d3b20d86626af206cbf780f6a6a12439a9c49e
-  io-console (0.9.4) sha256=a403304f32928ee85e56d457b4612ca43f2703b561a3258844992bd24085fbb1
+  io-console (0.9.5) sha256=83dd9bbf4c4680416629245b39cd4212eb5f4d9a4ea91804870c1f6b846414d5
   jaro_winkler (1.5.6) sha256=007db7805527ada1cc12f2547676181d63b0a504ec4dd7a9a2eb2424521ccd81
   logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
   method_source (1.1.0) sha256=181301c9c45b731b4769bc81e8860e72f9161ad7d66dd99103c9ab84f560f5c5
@@ -138,8 +139,8 @@ CHECKSUMS
   rubocop (0.66.0) sha256=f05a6896f367765b3f0fba663d0add120444f8de604dada405662b10a0860f5a
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
   stringio (3.2.0) sha256=c37cb2e58b4ffbd33fe5cd948c05934af997b36e0b6ca6fdf43afa234cf222e1
-  typhoeus (1.6.0) sha256=bacc41c23e379547e29801dc235cd1699b70b955a1ba3d32b2b877aa844c331d
+  typhoeus (1.7.1) sha256=86dcb6d787ee08e34947c9436b24af3c4b02880dc83c466b6ca4dbfc53c2ee7f
   unicode-display_width (1.5.0) sha256=9890eebd24feb4cb0e0542c9b8c6beecb40cda27be8c7afe49312625b36156eb
 
 BUNDLED WITH
-  4.0.20
+  4.0.23

data/README.md

@@ -1,7 +1,8 @@
 # DocSpring Ruby SDK
 
 The official Ruby 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/) ·
 [RubyGems](https://rubygems.org/gems/docspring) · [Changelog](https://github.com/DocSpring/docspring-ruby/blob/main/CHANGELOG.md)
@@ -9,7 +10,7 @@ templates with your data, generates PDFs from HTML templates, combines PDFs and
 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.1.0. Requires Ruby >= 2.7.
+Version 4.3.0. Requires Ruby >= 2.7.
 
 ## Install and configure
 
@@ -96,6 +97,7 @@ Ruby code for every method.
 | [`create_submission`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#create_submission) | Generate a PDF |
 | [`create_submission_batch`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#create_submission_batch) | Generate PDFs in a batch |
 | [`create_template`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#create_template) | Create a template |
+| [`create_template_preview`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#create_template_preview) | Preview a template with data |
 | [`create_webhook`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#create_webhook) | Create a webhook |
 | [`delete_custom_file`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#delete_custom_file) | Delete a custom file |
 | [`delete_folder`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#delete_folder) | Delete a folder |
@@ -116,6 +118,7 @@ Ruby code for every method.
 | [`get_template_diff`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#get_template_diff) | Compare a version of a template with the one before it |
 | [`get_template_model_code`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#get_template_model_code) | Generate typed code for a template's submission data |
 | [`get_template_page_images`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#get_template_page_images) | Get images of a template's pages |
+| [`get_template_preview`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#get_template_preview) | Get a template preview |
 | [`get_template_schema`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#get_template_schema) | Get the JSON Schema of a template's submission data |
 | [`get_webhook`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#get_webhook) | Get a webhook |
 | [`list_combined_pdfs`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#list_combined_pdfs) | List combined PDFs |
@@ -136,11 +139,11 @@ Ruby code for every method.
 | [`test_authentication`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#test_authentication) | Test authentication |
 | [`update_signature_request`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#update_signature_request) | Update a signature request |
 | [`update_template`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#update_template) | Update a template |
-| [`update_template_document`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#update_template_document) | Replace a template's PDF |
+| [`update_template_document`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#update_template_document) | Replace a template's document |
 | [`update_template_fields`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#update_template_fields) | Update a template's fields |
 | [`update_webhook`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#update_webhook) | Update a webhook |
-| [`upload_template`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#upload_template) | Create a PDF template from an uploaded PDF |
-| [`upload_template_document`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#upload_template_document) | Replace a template's PDF with an uploaded PDF |
+| [`upload_template`](https://github.com/DocSpring/docspring-ruby/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-ruby/blob/main/docs/Client.md#upload_template_document) | Replace a template's document with an uploaded file |
 | [`validate_submission`](https://github.com/DocSpring/docspring-ruby/blob/main/docs/Client.md#validate_submission) | Check a submission without creating it |
 
 ## Errors
@@ -158,7 +161,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 leaves out a response field added to the API after this release.
-- 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-ruby/blob/main/CHANGELOG.md) lists
 what each release adds.
@@ -175,6 +178,8 @@ On top of the generated code, we add:
 
 - A client constructor that reads your credentials, region and host from the environment.
 - A fix for multipart PUT requests in Ethon (file uploads to `upload_template_document`).
+- Dates and times in a request (`created_after`, a model's date-time attribute) can be a `Time`, `DateTime` or `Date`, sent as RFC 3339 strings. A `Date` is midnight UTC.
+- `DocSpring.verify_webhook_signature(payload, signature_header, secret)` checks a webhook request's `X-DocSpring-Signature` header, with `tolerance:` and `now:` keywords.
 
 Each release regenerates every file, so a change made only here would be lost in the next one. Issues and pull
 requests are welcome all the same: [open an issue](https://github.com/DocSpring/docspring-ruby/issues) or a pull request, or email