atmon docs

REFERENCE/TOOLKITS/DOCUSIGN.MD

DocuSign

Electronic signatures. Send documents for signature, see who has signed, remind or void an envelope, and send from templates.

PropertyValue
Slugdocusign
Definition version0.1.0
Base URLhttps://na3.docusign.net/restapi/v2.1
Auth schemesoauth2
Action tools29
By class13 read, 12 write, 4 destructive
Triggers0
Provider rate limitnot declared, so outbound calls are unpaced

Measured routing accuracy

44 golden cases replayed through the router over the whole index: measured over corpus ea4f12ad2948 (65 toolkits, 2283 tools indexed and 13 declared uncallable), 29 cases written by hand and 15 cases from the paraphrase pass. A case counts as top-1 when its gold tool ranked first and top-8 when it reached the slate at all.

MeasureCasesShare
top-128/4463.6%
top-837/4484.1%

The sweep is offline: the reranker is a deterministic identity fake that returns candidates in the order retrieval produced them, so top-1 measures retrieval order rather than a reranked slate. just eval-live measures the same cases through the live reranker.

Authentication

Connect an entity with ConnectionsService.InitiateConnection, naming this toolkit's slug. Credentials stay in the connections vault; callers hold connected-account ids only.

oauth2

PropertyValue
Authorization URLhttps://account.docusign.com/oauth/auth
Token URLhttps://account.docusign.com/oauth/token
Default scopessignature
Refresh tokensyes, the refresh daemon renews ahead of expiry

Tools

29 action tools. The catalog-wide slug is docusign.<tool>, which is what search_tools returns and call_tool takes.

docusign.create_envelope

Create a new DocuSign envelope from one or more documents and recipients. Use when the user wants to create, prepare, or send a document for signature. Defaults to sending it immediately; pass status "created" to save it as an unsent draft instead. To send a draft later use send_envelope.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /accounts/{{params.account_id}}/envelopes.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id (GUID) the envelope belongs to.
carbon_copiesarray of objectnoPeople who receive a copy but don't need to sign.
carbon_copies[].emailstringyesRecipient's email address.
carbon_copies[].namestringyesRecipient's full name.
carbon_copies[].recipientIdstringyesNumber identifying this recipient, e.g. "2".
carbon_copies[].routingOrderstringyesDelivery order as a string, e.g. "2".
documentsarray of objectyesFiles that make up the envelope.
documents[].documentBase64stringyesBase64-encoded file content.
documents[].documentIdstringyesDocument number within the envelope, e.g. "1".
documents[].fileExtensionstringnoFile extension, e.g. "pdf".
documents[].namestringyesFile name shown to recipients
email_blurbstringnoOptional message body shown above the documents.
email_subjectstringyesSubject line recipients see in the signing email.
signersarray of objectyesPeople who must sign the envelope.
signers[].clientUserIdstringnoSet to mark this signer for embedded (in-app) signing instead of an email invite. Required later to generate a signing URL with create_recipient_view.
signers[].emailstringyesSigner's email address.
signers[].namestringyesSigner's full name.
signers[].recipientIdstringyesNumber identifying this signer, e.g. "1".
signers[].routingOrderstringyesSigning order as a string, e.g. "1".
statusstring, one of sent, creatednosent dispatches it now (default); created saves it as a draft.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
envelopeIdstring
statusstring
statusDateTimestring
uristring

Also retrieved by: "get this contract out for people to sign", "put together a document package and send it around for signatures", "start a new signing request for this file", "prep this agreement so my client can sign it", "kick off signatures on this paperwork".

docusign.send_envelope

Send an existing draft DocuSign envelope that hasn't gone out yet. Use when the user already created or saved an envelope and now wants to send, share, or dispatch it. For a brand-new document, use create_envelope instead, which can send in the same call.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesDraft envelope to send, from create_envelope or list_envelopes.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
envelopeIdstring
statusstring
statusDateTimestring

Also retrieved by: "go ahead and fire off that draft to the client now", "this one's ready, push it out to the signers", "get the saved paperwork moving to the recipients", "dispatch the pending contract I set aside earlier", "release that draft so it actually goes out".

docusign.get_envelope

Get one DocuSign envelope's current status by envelope id: sent, delivered, completed, declined, or voided, with the relevant timestamps. Use when the user already has an envelope id or wants to check where a specific signature request stands.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesEnvelope to look up.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
completedDateTimestring
declinedDateTimestring
emailSubjectstring
envelopeIdstring
sentDateTimestring
statusstring
voidedDateTimestring
voidedReasonstring

Also retrieved by: "has this contract been signed yet", "where does this agreement stand right now", "check on that paperwork I sent last week", "pull up the details for that signature request", "what's happening with the document I sent for signing".

docusign.list_envelopes

List or search DocuSign envelopes changed since a given date, filtered by status. Use when the user asks what's out for signature, what still needs signing, or wants to find an envelope by keyword rather than a known id.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/envelopes.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id to search within.
countintegernoMax results to return, default 100.
from_datestringyesOnly envelopes changed on or after this date, ISO 8601 (e.g. "2026-07-01"). Required by DocuSign; use something like 30 days back for a broad "what needs signing" search.
search_textstringnoFree-text match against envelope subject and recipient names.
start_positionintegernoOffset into the result set, for paging.
statusstring, one of sent, delivered, completed, declined, voided, created, anynoFilter by envelope status. Default any.
to_datestringnoOnly envelopes changed on or before this date, ISO 8601.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
envelopesarray of object
envelopes[].completedDateTimestring
envelopes[].emailSubjectstring
envelopes[].envelopeIdstring
envelopes[].sentDateTimestring
envelopes[].statusstring
resultSetSizestring
totalSetSizestring

Also retrieved by: "what's still waiting on someone's signature", "show me every agreement I've got out there", "what paperwork is pending right now", "find that contract I sent a while back", "what have I got out for people to sign".

docusign.update_envelope

Change a draft DocuSign envelope's email subject or message before it's sent. Use when the user wants to edit or update the subject line or note on an envelope that hasn't gone out yet. To change who signs it, use update_recipients; to send it, use send_envelope.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
email_blurbstringnoNew message body.
email_subjectstringnoNew subject line.
envelope_idstringyesDraft envelope to edit.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
envelopeIdstring
statusstring

Also retrieved by: "fix the subject line on that draft before it goes out", "change the message on this unsent agreement", "edit the note attached to that pending paperwork", "rename what recipients will see for this draft".

docusign.void_envelope

Void an in-progress DocuSign envelope, permanently cancelling the signature request before it's completed. Use when the user wants to void, cancel, kill, or retract a document that's out for signature. Recipients can no longer sign it; a completed envelope cannot be voided.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls PUT /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesEnvelope to void.
voided_reasonstringyesWhy the envelope is being voided, shown to recipients.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
envelopeIdstring
statusstring
voidedDateTimestring

Also retrieved by: "kill this signature request, it's a mistake", "pull the plug on that agreement before it's finished", "this deal fell through, cancel the paperwork", "yank that contract back, don't let anyone sign it", "scrap the pending agreement entirely".

docusign.list_envelope_documents

List the documents attached to a DocuSign envelope, with each document's id and name. Use before downloading a specific document, or when the user asks what files are in an envelope.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/documents.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesEnvelope whose documents to list.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
envelopeDocumentsarray of object
envelopeDocuments[].documentIdstring
envelopeDocuments[].namestring
envelopeDocuments[].typestring
envelopeDocuments[].uristring

Also retrieved by: "what files did I attach to that agreement", "show me everything included in this signature packet", "what's inside that paperwork bundle", "check which files are part of this signing request".

docusign.download_envelope_document

Download one specific document from a DocuSign envelope by document id. Use when the user wants the actual file, not just its status. For the whole signed packet in one file, use get_combined_document.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/documents/{{params.document_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
document_idstringyesDocument to download, from list_envelope_documents.
envelope_idstringyesEnvelope the document belongs to.

Also retrieved by: "grab the actual file from that signing packet", "give me the contract itself, not just its status", "save a copy of that one file from the agreement", "get me the pdf from that particular signature request".

docusign.get_combined_document

Download every document in a DocuSign envelope combined into a single PDF, in one call instead of one per document. Use when the user wants the whole signed packet or final file as one download.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/documents/combined.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
certificatebooleannoInclude the Certificate of Completion pages. Default false.
envelope_idstringyesEnvelope whose documents to combine.

Also retrieved by: "give me the whole signed packet as one file", "bundle everything together into a single download", "I want the entire agreement in one pdf, not piece by piece", "merge all the files from that signing request into one".

docusign.get_envelope_certificate

Download a DocuSign envelope's Certificate of Completion: the tamper-evident record of who signed, when, and from where. Use when the user needs proof of signing separate from the signed document itself.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/documents/certificate.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesEnvelope whose certificate to download.

Also retrieved by: "prove that this contract was actually signed", "grab the paperwork trail showing who signed and when", "I need documentation that this was legally completed", "give me the tamper-proof record for this agreement".

docusign.get_envelope_audit_trail

Get the full audit trail of status and delivery events for a DocuSign envelope: every view, send, and signature event with a timestamp. Use when the user wants a detailed history of what happened to a document, beyond just its current status.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/audit_events.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesEnvelope whose history to fetch.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
auditEventsarray of object
auditEvents[].eventFieldsarray of object
auditEvents[].eventFields[].namestring
auditEvents[].eventFields[].valuestring

Also retrieved by: "walk me through everything that happened to this agreement", "show me every action taken on that paperwork, step by step", "who opened this and when, give me the whole history", "I need a detailed log of this signing request's activity".

docusign.list_recipients

List every recipient on a DocuSign envelope, with each person's name, email, routing order, and delivery or signing status. Use when the user asks who's on an envelope, who still needs to sign, or wants a recipient id before updating one.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/recipients.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesEnvelope whose recipients to list.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
carbonCopiesarray of object
carbonCopies[].deliveredDateTimestring
carbonCopies[].emailstring
carbonCopies[].namestring
carbonCopies[].recipientIdstring
carbonCopies[].statusstring
signersarray of object
signers[].deliveredDateTimestring
signers[].emailstring
signers[].namestring
signers[].recipientIdstring
signers[].routingOrderstring
signers[].signedDateTimestring
signers[].statusstring

Also retrieved by: "who's on this agreement and have they signed yet", "show me everyone tied to that paperwork", "who's still holding up this contract", "give me the list of people involved in this signing request".

docusign.add_recipients

Add one or more new signers or CC recipients to a draft DocuSign envelope that hasn't been sent yet. Use when the user wants to add someone else to sign or be copied on a document before it goes out. Give at least one of signers or carbon_copies.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/recipients.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
carbon_copiesarray of objectnoNew CC-only recipients to add.
carbon_copies[].emailstringyes
carbon_copies[].namestringyes
carbon_copies[].recipientIdstringyes
carbon_copies[].routingOrderstringyes
envelope_idstringyesDraft envelope to add recipients to.
signersarray of objectnoNew signers to add.
signers[].clientUserIdstringnoSet to mark this signer for embedded signing instead of an email invite.
signers[].emailstringyesSigner's email address.
signers[].namestringyesSigner's full name.
signers[].recipientIdstringyesNumber identifying this signer, e.g. "2".
signers[].routingOrderstringyesSigning order as a string, e.g. "2".

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
carbonCopiesarray of object
carbonCopies[].emailstring
carbonCopies[].namestring
carbonCopies[].recipientIdstring
signersarray of object
signers[].emailstring
signers[].namestring
signers[].recipientIdstring

Also retrieved by: "put another person on this unsent contract", "get someone else added before this goes out", "loop in one more person on the paperwork", "include an extra signer on this draft".

docusign.update_recipients

Change an existing recipient's name, email, or routing (signing) order on a draft DocuSign envelope. Use when the user wants to fix a mistyped email, reorder who signs next, or edit a signer before the envelope has been sent.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/recipients.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesDraft envelope whose recipients to update.
signersarray of objectyesSigners to update, identified by their existing recipientId.
signers[].emailstringnoNew email address.
signers[].namestringnoNew full name.
signers[].recipientIdstringyesExisting signer to update.
signers[].routingOrderstringnoNew signing order as a string.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
signersarray of object
signers[].emailstring
signers[].namestring
signers[].recipientIdstring

Also retrieved by: "I typed her email wrong, fix it on this draft", "swap the signing order for the people on this agreement", "change who goes first on this pending contract", "correct a signer's info before this gets sent out".

docusign.delete_recipient

Remove one recipient entirely from a draft DocuSign envelope before it's sent. Use when the user wants to take someone off the signing list. Irreversible for that recipient's slot; the envelope must not have been sent yet.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/recipients/{{params.recipient_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesDraft envelope to remove the recipient from.
recipient_idstringyesRecipient to remove, from list_recipients.

Also retrieved by: "take that person off the signing list entirely", "drop a signer from this unsent agreement", "get rid of one of the people on this draft", "remove someone from the paperwork before it goes out".

docusign.resend_envelope

Resend the signing email notification to everyone who hasn't yet completed a DocuSign envelope. Use when the user wants to nudge, remind, or resend the invite to someone who hasn't signed. Doesn't change the document or recipient list.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/recipients.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesEnvelope to resend notifications for.

Also retrieved by: "nudge everyone who still hasn't signed", "ping the people who are dragging their feet on this", "fire off another reminder email for that contract", "poke the recipients again about that pending agreement".

docusign.get_recipient_tabs

Get the form fields (tabs) assigned to one recipient on a DocuSign envelope: signature blocks, initials, and date or text fields, with their positions and current values. Use when the user asks what a signer needs to fill in or where their signature goes.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/recipients/{{params.recipient_id}}/tabs.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesEnvelope the recipient belongs to.
recipient_idstringyesRecipient whose tabs to fetch, from list_recipients.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
dateSignedTabsarray of object
dateSignedTabs[].tabIdstring
dateSignedTabs[].valuestring
signHereTabsarray of object
signHereTabs[].documentIdstring
signHereTabs[].pageNumberstring
signHereTabs[].tabIdstring
textTabsarray of object
textTabs[].tabIdstring
textTabs[].valuestring

Also retrieved by: "what does this person actually need to fill out", "show me where their signature goes on the page", "what fields is this signer responsible for", "check what's left blank for that specific person".

docusign.create_recipient_view

Generate a one-time embedded signing URL for a recipient to sign a DocuSign envelope inside your own app instead of by email. Use when the user wants a signing link to share or embed rather than an email notification. The recipient must have been added with a clientUserId set.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/views/recipient.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
authentication_methodstring, one of none, emailnoHow the recipient's identity was verified before this view. Default none.
client_user_idstringyesSame clientUserId given when this recipient was added.
emailstringyesRecipient's email, must match the envelope recipient's email.
envelope_idstringyesEnvelope the recipient is signing.
recipient_idstringyesRecipient to generate the signing view for.
return_urlstringyesWhere DocuSign redirects the recipient after signing.
user_namestringyesRecipient's full name, must match the envelope recipient's name.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
urlstring

Also retrieved by: "give me a link so they can sign right inside our app", "I need an embedded signing session, not an email", "generate a URL this person can click to sign directly", "let them sign in-app instead of through their inbox".

docusign.get_envelope_notification

Get a DocuSign envelope's reminder and expiration settings: how many days until it expires and when reminder emails go out. Use when the user asks when an envelope expires or whether reminders are on.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/notification.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesEnvelope whose settings to fetch.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
expirationsobject
expirations.expireAfterstring
expirations.expireEnabledstring
expirations.expireWarnstring
remindersobject
reminders.reminderDelaystring
reminders.reminderEnabledstring
reminders.reminderFrequencystring

Also retrieved by: "when does this agreement actually expire", "are reminders even turned on for this contract", "check the nag schedule for that pending paperwork", "how long until this signing request times out".

docusign.update_envelope_notification

Turn on or change reminder emails and the expiration window for a DocuSign envelope. Use when the user wants to automatically remind signers, or change how many days an envelope stays valid before it expires.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/notification.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
envelope_idstringyesEnvelope whose settings to change.
expire_afterintegernoDays before the envelope expires.
expire_enabledbooleannoTurn automatic expiration on or off.
expire_warnintegernoDays before expiration to warn the signer.
reminder_delayintegernoDays after sending before the first reminder.
reminder_enabledbooleannoTurn reminder emails on or off.
reminder_frequencyintegernoDays between repeat reminders.

Also retrieved by: "start nagging them every few days until they sign", "set this to expire in two weeks if nobody signs", "change how often the reminder emails go out", "turn on automatic follow-ups for this agreement".

docusign.add_envelope_document

Add another document to a draft DocuSign envelope before it's sent. Use when the user wants to attach or include one more file in a document package that isn't out yet.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/documents/{{params.document_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
document_base64stringyesBase64-encoded file content.
document_idstringyesDocument number to assign, e.g. "2".
envelope_idstringyesDraft envelope to add the document to.
file_extensionstringnoFile extension, e.g. "pdf".
namestringyesFile name shown to recipients.

Also retrieved by: "toss one more file into this unsent packet", "I forgot a page, attach it before this goes out", "throw another file into the pending signature request", "include an extra attachment on this draft".

docusign.delete_envelope_document

Remove a document from a draft DocuSign envelope before it's sent. Use when the user wants to take a file out of a document package that hasn't gone out yet. Irreversible for that document slot.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /accounts/{{params.account_id}}/envelopes/{{params.envelope_id}}/documents/{{params.document_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelope belongs to.
document_idstringyesDocument to remove, from list_envelope_documents.
envelope_idstringyesDraft envelope to remove the document from.

Also retrieved by: "take that file back out of the unsent packet", "I attached the wrong version, remove it", "drop one of the files from this pending agreement", "get rid of an attachment before this ships".

docusign.list_templates

List the reusable DocuSign templates saved on the account, with each template's name and id. Use when the user asks what templates exist or wants to find one to send from.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/templates.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id to list templates from.
countintegernoMax results to return, default 100.
search_textstringnoFree-text match against template name.
start_positionintegernoOffset into the result set, for paging.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
envelopeTemplatesarray of object
envelopeTemplates[].createdstring
envelopeTemplates[].descriptionstring
envelopeTemplates[].namestring
envelopeTemplates[].templateIdstring
resultSetSizestring
totalSetSizestring

Also retrieved by: "what saved forms do I have to send from", "show me the reusable paperwork I've already set up", "find that boilerplate agreement I use all the time", "what's already built and ready to send".

docusign.get_template

Get one DocuSign template's full details by template id: its documents and signer roles. Use after list_templates or when the user already knows which template they mean.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/templates/{{params.template_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the template belongs to.
template_idstringyesTemplate to look up.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
descriptionstring
documentsarray of object
documents[].documentIdstring
documents[].namestring
emailSubjectstring
namestring
recipientsobject
recipients.signersarray of object
recipients.signers[].recipientIdstring
recipients.signers[].roleNamestring
recipients.signers[].routingOrderstring
templateIdstring

Also retrieved by: "pull up the details on that saved form", "show me what's inside our standard agreement setup", "what roles are built into that boilerplate paperwork", "check the fields on our go-to contract form".

docusign.create_template

Create a new reusable DocuSign template from documents and signer roles. Use when the user wants to save a document package as a template to reuse, instead of building it from scratch every time.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /accounts/{{params.account_id}}/templates.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id to create the template in.
descriptionstringnoOptional longer description of the template.
documentsarray of objectyesFiles that make up the template.
documents[].documentBase64stringyesBase64-encoded file content.
documents[].documentIdstringyesDocument number, e.g. "1".
documents[].fileExtensionstringnoFile extension, e.g. "pdf".
documents[].namestringyesFile name.
namestringyesTemplate name.
signersarray of objectyesPlaceholder signer roles to fill in later when sending from this template.
signers[].recipientIdstringyesNumber identifying this role, e.g. "1".
signers[].roleNamestringyesRole name, e.g. "Client".
signers[].routingOrderstringyesSigning order as a string, e.g. "1".

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
namestring
templateIdstring
uristring

Also retrieved by: "save this as something I can reuse later", "turn this document into a reusable form", "set up a standard version of this agreement for next time", "build a boilerplate I don't have to recreate each time".

docusign.delete_template

Permanently delete a DocuSign template by template id. Use when the user wants to remove or get rid of a saved template. Irreversible; envelopes already created from it are unaffected.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /accounts/{{params.account_id}}/templates/{{params.template_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the template belongs to.
template_idstringyesTemplate to delete.

Also retrieved by: "get rid of that saved form for good", "we don't use that boilerplate anymore, remove it", "clean out an old reusable agreement we no longer need", "wipe that standard form from our account".

docusign.create_envelope_from_template

Create and, by default, send a new DocuSign envelope from an existing template, filling in each role with a real signer's name and email. Use when the user wants to send a document using a saved template rather than uploading files from scratch.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /accounts/{{params.account_id}}/envelopes.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id to create the envelope in.
email_subjectstringyesSubject line recipients see in the signing email.
statusstring, one of sent, creatednosent dispatches it now (default); created saves it as a draft.
template_idstringyesTemplate to send from, from list_templates.
template_rolesarray of objectyesReal signers assigned to each of the template's roles.
template_roles[].emailstringyesSigner's email address.
template_roles[].namestringyesSigner's full name.
template_roles[].roleNamestringyesRole name as defined on the template.
template_roles[].routingOrderstringnoOverride the template's default signing order.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
envelopeIdstring
statusstring
uristring

Also retrieved by: "send our standard agreement to a new client", "fill in the boilerplate with this person's info and send it", "use our go-to form for this new signer", "run the usual paperwork with someone new plugged in".

docusign.list_folders

List the folders in a DocuSign account, such as Inbox, Sent, Drafts, and Completed, with each folder's id and name. Use before moving an envelope into, or finding envelopes within, a specific folder.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /accounts/{{params.account_id}}/folders.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id to list folders from.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
foldersarray of object
folders[].folderIdstring
folders[].namestring
folders[].uristring

Also retrieved by: "what folders do we even have set up in here", "show me where things get filed", "what's the folder structure look like".

docusign.move_envelope

Move one or more DocuSign envelopes into a different folder. Use when the user wants to file, organize, or move a document into a folder like Archive or a custom folder. Folder ids come from list_folders.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /accounts/{{params.account_id}}/folders/{{params.folder_id}}.

Arguments:

ArgumentTypeRequiredNotes
account_idstringyesDocuSign account id the envelopes belong to.
envelope_idsarray of stringyesEnvelope ids to move.
folder_idstringyesFolder to move the envelopes into.

Also retrieved by: "file that contract away in the right place", "shift this agreement into a different folder", "put that paperwork into the archive", "organize this signed document into its folder".