Aller au contenu
Documentation

Modifier les réglages hérités du modèle

Changer, pour cet envoi seulement, le nom du parcours, sa durée de validité, ses relances ou son mode d'essai.

2 min de lecture Mise à jour le 9 novembre 2026
cURL
curl -X POST "https://staging-api.docage.com/Transactions/CreateFullTransaction" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
  -F "TemplateId=aaaaaaaa-0000-4000-8000-000000000001" \
  -F "Client=00000000-0000-4000-8000-000000000201" \
  -F 'Transaction={"Name":"Contrat de prestation – Atelier Lumière","DaysBeforeEnding":10,"Reminder":2,"MaximumReminders":3}'

La clé Transaction porte les propriétés qui changent ; les autres restent celles du modèle.

Propriété Ce qu'elle règle
Name Le nom du parcours, 255 caractères au plus : celui des emails et des documents téléchargés.
DaysBeforeEnding Sa durée de validité, en jours, de 1 à 30 (30 d'office) : le parcours expire ce nombre de jours après son envoi. EndDate, une date UTC, la fixe à la place.
Reminder Ses relances automatiques : 0 aucune, 1 chaque jour, 2 tous les deux jours, 7 chaque semaine, 14 toutes les deux semaines, 30 chaque mois.
MaximumReminders Le nombre de relances automatiques, de 1 à 5.
IsTest true : un parcours d'essai, sans consommation de crédits, aux documents filigranés et sans valeur probante.
ExternalId Votre propre référence, 128 caractères au plus — le numéro du dossier dans votre outil.

Les pièges

  • Une valeur qui ne se lit pas est ignorée, sans erreur : un nombre hors bornes, un nom de propriété mal écrit. Relisez le parcours rendu.
  • DaysBeforeEnding n'est pas contrôlé par cette route : restez entre 1 et 30.
  • Une organisation qui n'est pas encore en production crée toujours des parcours d'essai, quel que soit IsTest.
  • MailSettings remplace tous les réglages d'emails du modèle, pas seulement ceux que vous envoyez : voir Personnaliser l'email d'invitation à signer.
  • Les réglages d'un participant se changent sous son identifiant convivial : voir Changer le mode de signature d'un participant.