# 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 Email Settings API
  version: 1.0.0
extends: openapi/docusign-envelopeemailsettings-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: 4
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/email_settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an envelope's email overrides
      effect: read
      questions:
      - What reply-to and BCC overrides are set on an envelope?
      - Can I check which email overrides an envelope uses?
      instructions:
      - text: Get email setting overrides for envelope {envelope} in account {account}.
        slots:
          envelope: path.envelopeId
          account: path.accountId
      - text: Show the reply-to and BCC overrides on envelope {envelope}.
        slots:
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/email_settings'].put
  update:
    x-apievangelist-phrasing:
      intent: Change an envelope's existing email overrides
      effect: write
      questions:
      - How do I change the reply-to address already overridden on an envelope?
      - Can I clear one email override by setting it to an empty value?
      instructions:
      - text: Change the reply-to address on envelope {envelope} in account {account} to {reply_email}.
        slots:
          envelope: path.envelopeId
          account: path.accountId
          reply_email: requestBody.replyEmailAddressOverride
      - text: Update the existing reply-to name on envelope {envelope} to {reply_name}.
        slots:
          envelope: path.envelopeId
          reply_name: requestBody.replyEmailNameOverride
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/email_settings'].post
  update:
    x-apievangelist-phrasing:
      intent: Add email overrides to an envelope
      effect: write
      questions:
      - Can replies to an envelope's emails go to a different address?
      - Is it possible to BCC an archive address on envelope emails?
      instructions:
      - text: Add a reply-to override of {reply_email} to envelope {envelope} in account {account}.
        slots:
          reply_email: requestBody.replyEmailAddressOverride
          envelope: path.envelopeId
          account: path.accountId
      - text: BCC {bcc} on future emails for envelope {envelope}.
        slots:
          bcc: requestBody.bccEmailAddresses
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/email_settings'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove all email overrides from an envelope
      effect: destructive
      questions:
      - How do I go back to the account's normal email settings for an envelope?
      - Does removing overrides affect emails that were already sent?
      instructions:
      - text: Delete all email overrides on envelope {envelope} in account {account}.
        slots:
          envelope: path.envelopeId
          account: path.accountId
      - text: Clear every reply-to and BCC override from envelope {envelope}.
        slots:
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'