discard_envelope
Discard draft digital signature envelopes when deletion permissions are unavailable. This tool moves envelopes to a discarded state as an alternative to permanent deletion.
Instructions
Discard a draft envelope. Moves it to discarded state. Use this instead of delete when the API key lacks ROLE_ENVELOPE_DELETE.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| envelopeId | Yes | Envelope UUID |
Implementation Reference
- src/api.js:108-110 (handler)The core implementation of the discard_envelope operation that makes the API call.
export function discardEnvelope(creds, envelopeId) { return apiCall('POST', `/api/envelopes/${envelopeId}/discard`, creds); } - src/index.js:295-309 (registration)The MCP tool registration for 'discard_envelope', wrapping the api.discardEnvelope function.
server.tool( 'discard_envelope', 'Discard a draft envelope. Moves it to discarded state. Use this instead of delete when the API key lacks ROLE_ENVELOPE_DELETE.', { envelopeId: z.string().describe('Envelope UUID'), }, async ({ envelopeId }) => { try { const data = await api.discardEnvelope(creds, envelopeId); return result(data); } catch (err) { return errorResult(err); } } );