# 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 Invoices API
  version: 1.0.0
extends: openapi/docusign-invoices-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_invoices'].get
  update:
    x-apievangelist-phrasing:
      intent: List billing invoices
      effect: read
      questions:
      - Where can I see my DocuSign invoices for the past year?
      - Can I list invoices between two dates?
      instructions:
      - text: List billing invoices for account {account}.
        slots:
          account: path.accountId
      - text: Show invoices for account {account} from {from_date} to {to_date}.
        slots:
          account: path.accountId
          from_date: query.from_date
          to_date: query.to_date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/billing_invoices/{invoiceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a billing invoice
      effect: read
      questions:
      - How do I get the details of one invoice?
      - Can I download a specific invoice as a PDF?
      instructions:
      - text: Get invoice {invoice} for account {account}.
        slots:
          invoice: path.invoiceId
          account: path.accountId
      - text: Download the PDF of invoice {invoice} on account {account}.
        slots:
          invoice: path.invoiceId
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/billing_invoices_past_due'].get
  update:
    x-apievangelist-phrasing:
      intent: List past-due invoices
      effect: read
      questions:
      - Do I have any overdue invoices on my account?
      - Can past-due invoices be paid through the REST API?
      instructions:
      - text: List past-due invoices for account {account}.
        slots:
          account: path.accountId
      - text: Show which invoices on account {account} are overdue.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'