From dc8c5a746d6c7649389958a42a37d097cb950b67 Mon Sep 17 00:00:00 2001 From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> Date: Wed, 11 Nov 2026 18:01:59 +0000 Subject: [PATCH 1/2] docs: link n8n example from LibreSign 14 integration guides Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> --- developer_manual/api/external-email-signers.rst | 14 ++++++++++++-- developer_manual/integration/index.rst | 6 ++++++ 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/developer_manual/api/external-email-signers.rst b/developer_manual/api/external-email-signers.rst index 2143d023..3404a243 100644 --- a/developer_manual/api/external-email-signers.rst +++ b/developer_manual/api/external-email-signers.rst @@ -47,20 +47,30 @@ branch (not in another release's source): * `Bash client (flow.sh) `_ * `PHP client (flow.php) `_ -* `LibreSign 14 fixture (request-14.json) `_ +* `LibreSign 14 fixture (request-14.json) `_ Clone the **matching documentation branch**, then work in the examples directory (Git required): .. code-block:: bash - git clone --depth 1 --branch main https://github.com/LibreSign/documentation.git + git clone --depth 1 --branch stable14 https://github.com/LibreSign/documentation.git cd documentation/examples/external-email-signers Keep the clients and their ``request-*.json`` fixtures together. Consult this release's :doc:`openapi` and its pinned `OpenAPI JSON `_ when adapting the request to a real integration. +For a ready-to-import n8n workflow, see the `shared LibreSign + n8n guide +`_. It uses a single external signer, explicit invitation, +bounded OCS polling and an authorized WebDAV download. Select this +LibreSign release in the workflow configuration: versions 13/14 use +``mandatory: 1``; versions 15/development use +``requirement: "required"``. Native completion events belong to the +development documentation and are not required by the polling workflow. +The n8n files are maintained on the development branch; do not replace +the release-specific cURL/PHP fixtures with development payloads. + .. include:: _external-email-signers-release.inc The scripts POST /request-signature, diff --git a/developer_manual/integration/index.rst b/developer_manual/integration/index.rst index 56571432..609b5807 100644 --- a/developer_manual/integration/index.rst +++ b/developer_manual/integration/index.rst @@ -83,6 +83,12 @@ Read the relevant guide integration with fixture selection and authorized PDF retrieval. - :doc:`../api/openapi` — the **actual API schema for this release**, including required properties and supported responses. +- `n8n importable signing workflow `_ — one external email + signer, App Password authentication, bounded OCS polling and authorized + WebDAV retrieval. The shared example selects the request schema for + LibreSign 13/14 (``mandatory``) or 15/development (``requirement``). + Native completion events are documented only for development; the + importable workflow uses polling on every supported release. Contract and ownership boundaries --------------------------------- From 9e50e18de6adf4e0f8a9740d068569f9dc113ce6 Mon Sep 17 00:00:00 2001 From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> Date: Wed, 11 Nov 2026 22:50:39 +0000 Subject: [PATCH 2/2] fix(docs): point LibreSign 14 n8n links to the tested workflow Replace pinned links to the pre-fix Code node implementation. Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> --- developer_manual/api/external-email-signers.rst | 2 +- developer_manual/integration/index.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/developer_manual/api/external-email-signers.rst b/developer_manual/api/external-email-signers.rst index 3404a243..a51d2b73 100644 --- a/developer_manual/api/external-email-signers.rst +++ b/developer_manual/api/external-email-signers.rst @@ -62,7 +62,7 @@ release's :doc:`openapi` and its pinned `OpenAPI JSON `_ when adapting the request to a real integration. For a ready-to-import n8n workflow, see the `shared LibreSign + n8n guide -`_. It uses a single external signer, explicit invitation, +`_. It uses a single external signer, explicit invitation, bounded OCS polling and an authorized WebDAV download. Select this LibreSign release in the workflow configuration: versions 13/14 use ``mandatory: 1``; versions 15/development use diff --git a/developer_manual/integration/index.rst b/developer_manual/integration/index.rst index 609b5807..f2f9ab01 100644 --- a/developer_manual/integration/index.rst +++ b/developer_manual/integration/index.rst @@ -83,7 +83,7 @@ Read the relevant guide integration with fixture selection and authorized PDF retrieval. - :doc:`../api/openapi` — the **actual API schema for this release**, including required properties and supported responses. -- `n8n importable signing workflow `_ — one external email +- `n8n importable signing workflow `_ — one external email signer, App Password authentication, bounded OCS polling and authorized WebDAV retrieval. The shared example selects the request schema for LibreSign 13/14 (``mandatory``) or 15/development (``requirement``).