Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 10 additions & 8 deletions developer_manual/api/external-email-signers.rst
Original file line number Diff line number Diff line change
Expand Up @@ -62,14 +62,16 @@ release's :doc:`openapi` and its pinned `OpenAPI JSON <openapi.json>`_ when
adapting the request to a real integration.

For a ready-to-import n8n workflow, see the `shared LibreSign + n8n guide
<https://github.com/LibreSign/documentation/blob/560861b9ac0c4673cac490aaf8de226d227fa792/examples/n8n/README.md>`_. 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.
<https://github.com/LibreSign/documentation/blob/a7b772cf579fcbd734810661f6e2104bd8444e6a/examples/n8n/README.md>`_. It uses a single external signer, explicit invitation,
bounded OCS polling, automatic WebDAV discovery and authenticated download
from the default LibreSign folder. 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 polling.
Automated discovery was exercised only on LibreSign 15.0.12; versions 13,
14 and development still require runtime verification. The link pins the
README and its relative 21-node JSON workflow to one immutable revision.
Do not replace release-specific cURL/PHP fixtures with development payloads.

.. include:: _external-email-signers-release.inc

Expand Down
14 changes: 8 additions & 6 deletions developer_manual/integration/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -83,12 +83,14 @@ 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 <https://github.com/LibreSign/documentation/blob/560861b9ac0c4673cac490aaf8de226d227fa792/examples/n8n/README.md>`_ — 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.
- `n8n importable signing workflow <https://github.com/LibreSign/documentation/blob/a7b772cf579fcbd734810661f6e2104bd8444e6a/examples/n8n/README.md>`_ — one external email
signer, App Password authentication, bounded OCS polling and automatic
WebDAV discovery and authenticated download in the default LibreSign
folder. The shared example selects the request schema for LibreSign
13/14 (``mandatory``) or 15/development (``requirement``). The discovery
step was exercised only on LibreSign 15.0.12; versions 13, 14 and
development still require runtime verification. Native completion
events are documented only for development; the workflow uses OCS polling.

Contract and ownership boundaries
---------------------------------
Expand Down
Loading