Skip to main content
This document covers docusign_get_envelope, the envelope status lookup tool exposed through the Agents Platform.

​
Authentication

DocuSign tools use the DocuSign connector, which authenticates with JWT Grant (server-to-server). Users configure integration_key, user_id and private_key, plus optional account_id and environment. See docusign.md for setup and the one-time admin consent step.

​
docusign_get_envelope

Reads a DocuSign envelope’s current state by id. This is a read-only tool.

​
Inputs

Required:

​
Status values

delivered is the one most often misread: it means opened, not signed. Only completed means the document is done.

​
Output

Structured content includes:
  • envelope_id
  • envelope: full envelope object — subject, and the sent / delivered / completed / declined / voided timestamps
  • envelope_status: the raw status string, lifted out
  • is_completed: boolean, true only for completed
envelope_status and is_completed are surfaced at the top level so a decision step can branch without reaching into a nested object.

​
Notes

  • Call this before re-sending anything. Sending is billed per envelope and cannot be undone, and this is the only way to know an envelope already exists.
  • Polling this tool is currently how envelope lifecycle changes are observed; DocuSign Connect webhooks are not wired up yet.