# 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 Watermarks API
  version: 1.0.0
extends: openapi/docusign-accountwatermarks-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}/watermark'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the account watermark settings
      effect: read
      questions:
      - What watermark is applied to our documents right now?
      - Is a watermark currently enabled on my account?
      instructions:
      - text: Get the watermark settings for account {account}.
        slots:
          account: path.accountId
      - text: Show the current document watermark on account {account}.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/watermark'].put
  update:
    x-apievangelist-phrasing:
      intent: Change the account watermark
      effect: write
      questions:
      - How do I change the watermark text or font on our documents?
      - Can I turn the account watermark on or off?
      instructions:
      - text: Set the watermark text on account {account} to {text_value}.
        slots:
          account: path.accountId
          text_value: requestBody.watermarkText
      - text: Change the watermark on account {account} to font size {size} at transparency {transparency}.
        slots:
          account: path.accountId
          size: requestBody.fontSize
          transparency: requestBody.transparency
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/watermark/preview'].put
  update:
    x-apievangelist-phrasing:
      intent: Preview a watermark before saving it
      effect: read
      questions:
      - Can I see what a watermark looks like before applying it?
      - Is there a way to test watermark angle and color without saving?
      instructions:
      - text: Preview watermark text {text_value} for account {account}.
        slots:
          text_value: requestBody.watermarkText
          account: path.accountId
      - text: Show a preview of a watermark at angle {angle} in color {color} without saving.
        slots:
          angle: requestBody.displayAngle
          color: requestBody.fontColor
      method: generated
      generated: '2026-10-01'