# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DocuSign REST Envelope Attachments API
  version: 1.0.0
extends: openapi/docusign-envelopeattachments-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/attachments'].get
  update:
    x-apievangelist-phrasing:
      intent: List an envelope's attachments
      effect: read
      questions:
      - What attachments are on an envelope?
      - Can I see every attachment added to a sent envelope?
      instructions:
      - text: List attachments on envelope {envelope} in account {account}.
        slots:
          envelope: path.envelopeId
          account: path.accountId
      - text: Show all attachments for envelope {envelope}.
        slots:
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/attachments'].put
  update:
    x-apievangelist-phrasing:
      intent: Add several attachments to an envelope
      effect: write
      questions:
      - Can I attach multiple files to a draft or in-process envelope in one call?
      - Which file formats are allowed as envelope attachments?
      instructions:
      - text: Add attachments {attachments} to envelope {envelope} in account {account}.
        slots:
          attachments: requestBody.attachments
          envelope: path.envelopeId
          account: path.accountId
      - text: Upload the attachment batch {attachments} onto envelope {envelope}.
        slots:
          attachments: requestBody.attachments
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/attachments'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete attachments from a draft envelope
      effect: destructive
      questions:
      - How do I remove attachments from an envelope that hasn't been sent?
      - Can attachments be deleted after an envelope is sent?
      instructions:
      - text: Delete attachments {attachments} from envelope {envelope} in account {account}.
        slots:
          attachments: requestBody.attachments
          envelope: path.envelopeId
          account: path.accountId
      - text: Remove attachment entries {attachments} from draft envelope {envelope}.
        slots:
          attachments: requestBody.attachments
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/attachments/{attachmentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one envelope attachment
      effect: read
      questions:
      - Can I download a specific attachment from an envelope?
      - Where do I get the contents of one envelope attachment?
      instructions:
      - text: Get attachment {attachment} from envelope {envelope} in account {account}.
        slots:
          attachment: path.attachmentId
          envelope: path.envelopeId
          account: path.accountId
      - text: Download envelope attachment {attachment}.
        slots:
          attachment: path.attachmentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/attachments/{attachmentId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or replace a single envelope attachment
      effect: write
      questions:
      - Can I set a label and access control on one attachment I add to an envelope?
      - Is it possible to attach a file by remote URL rather than uploading the data?
      instructions:
      - text: Add attachment {attachment} named {name} to envelope {envelope} in account {account}.
        slots:
          attachment: path.attachmentId
          name: requestBody.name
          envelope: path.envelopeId
          account: path.accountId
      - text: Attach the file at {remote_url} as attachment {attachment} on envelope {envelope}.
        slots:
          remote_url: requestBody.remoteUrl
          attachment: path.attachmentId
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'