# 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 Payments API
  version: 1.0.0
extends: openapi/docusign-payments-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}/billing_payments'].get
  update:
    x-apievangelist-phrasing:
      intent: List billing payments
      effect: read
      questions:
      - What payments has my account made over the last year?
      - Can I list billing payments between two dates?
      instructions:
      - text: List billing payments for account {accountId}.
        slots:
          accountId: path.accountId
      - text: Show payments made from {from_date} to {to_date}.
        slots:
          from_date: query.from_date
          to_date: query.to_date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/billing_payments'].post
  update:
    x-apievangelist-phrasing:
      intent: Pay a past due invoice
      effect: write
      questions:
      - Can I pay an overdue invoice through the API?
      - When is a payment allowed against a past due invoice?
      instructions:
      - text: Pay {paymentAmount} toward the past due invoice on account {accountId}.
        slots:
          paymentAmount: requestBody.paymentAmount
          accountId: path.accountId
      - text: Post a payment of {paymentAmount} for our overdue bill.
        slots:
          paymentAmount: requestBody.paymentAmount
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/billing_payments/{paymentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a billing payment
      effect: read
      questions:
      - Can I see the details of one specific payment?
      - Who is allowed to view billing payment details?
      instructions:
      - text: Show payment {paymentId}.
        slots:
          paymentId: path.paymentId
      - text: Get billing payment {paymentId} for account {accountId}.
        slots:
          paymentId: path.paymentId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'