# 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 Account Consumer Disclosures API
  version: 1.0.0
extends: openapi/docusign-accountconsumerdisclosures-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: 3
- target: $.paths['/v2/accounts/{accountId}/consumer_disclosure'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the account's e-signature disclosure
      effect: read
      questions:
      - What does my account's Electronic Record and Signature Disclosure say?
      - Can I request the default disclosure in a particular language via a query option?
      instructions:
      - text: Get the electronic record and signature disclosure for account {account}.
        slots:
          account: path.accountId
      - text: Show account {account}'s default consumer disclosure in language {lang}.
        slots:
          account: path.accountId
          lang: query.langCode
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/consumer_disclosure/{langCode}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the disclosure for a specific language
      effect: read
      questions:
      - How do I fetch the Spanish version of our signing disclosure?
      - Is the language-specific disclosure ever different from the account default?
      instructions:
      - text: Get the consumer disclosure for language code {lang} in account {account}.
        slots:
          lang: path.langCode
          account: path.accountId
      - text: Show the {lang} translation of our e-signature disclosure.
        slots:
          lang: path.langCode
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/consumer_disclosure/{langCode}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit the e-signature disclosure for a language
      effect: write
      questions:
      - Can I customize the company name and withdrawal instructions in our disclosure?
      - Where do I change how signers withdraw consent to electronic records?
      instructions:
      - text: Update the {lang} consumer disclosure for account {account} with company name {company}.
        slots:
          lang: path.langCode
          account: path.accountId
          company: requestBody.companyName
      - text: Set the withdrawal email in the {lang} disclosure to {email}.
        slots:
          lang: path.langCode
          email: requestBody.withdrawEmail
      method: generated
      generated: '2026-10-01'