# 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 Consumer Disclosures API
  version: 1.0.0
extends: openapi/docusign-envelopeconsumerdisclosures-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: 2
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/consumer_disclosure'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the disclosure shown to an envelope recipient
      effect: read
      questions:
      - Which e-signature disclosure did a recipient on my envelope see?
      - Can I request a recipient's disclosure in a different language with a query option?
      instructions:
      - text: Get the consumer disclosure for recipient {recipient} on envelope {envelope} in account {account}.
        slots:
          recipient: path.recipientId
          envelope: path.envelopeId
          account: path.accountId
      - text: Show recipient {recipient}'s signing disclosure for envelope {envelope} in language {lang}.
        slots:
          recipient: path.recipientId
          envelope: path.envelopeId
          lang: query.langCode
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/consumer_disclosure/{langCode}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a recipient's disclosure by language code
      effect: read
      questions:
      - Can I fetch an envelope recipient's disclosure for a language set in the path?
      - Is the language-coded recipient disclosure endpoint reserved?
      instructions:
      - text: Fetch the reserved path-language {lang} disclosure version for signer {recipient} of envelope {envelope}, account {account}.
        slots:
          lang: path.langCode
          recipient: path.recipientId
          envelope: path.envelopeId
          account: path.accountId
      - text: Show the language-coded {lang} disclosure that recipient {recipient} would see.
        slots:
          lang: path.langCode
          recipient: path.recipientId
      method: generated
      generated: '2026-10-01'