DocuSign

Purpose

Work with DocuSign's eSignature REST API v2.1: list envelopes, fetch envelope details and recipient status, prepare DRAFT envelopes (never sent automatically), send a draft envelope to signers, and download envelope documents. Every command runs against the demo environment unless you pass --env prod: demo.docusign.net sends no legally effective documents. Reach for this when the user needs to prepare, send, or track a DocuSign signature request.

Tooling

All commands go through bin/docusign.py. Demo is the default (--env demo); add --env prod for production:

bin/docusign.py auth                                  # verify OAuth; list accounts
bin/docusign.py envelopes --from-date 2026-09-01      # list envelopes
bin/docusign.py envelope-get --envelope-id ENV_ID     # envelope details
bin/docusign.py envelope-status --envelope-id ENV_ID  # status + recipient state
bin/docusign.py envelope-create --file envelope.json \
    --confirm "create DRAFT envelope from envelope.json"   # DRAFT only
bin/docusign.py envelope-send --envelope-id ENV_ID \
    --confirm "send envelope ENV_ID to signers (legally binding signature request)"
                                                      # HIGH: has legal effect
bin/docusign.py document-download --envelope-id ENV_ID \
    --document-id combined --out signed.pdf           # download documents

envelope-create takes a DocuSign envelope definition in JSON and forces "status": "created" so it always lands as a draft. --document-id combined downloads the full envelope as one file. --account-id overrides the default account from /oauth/userinfo on any command that needs one.