# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Leadping Payment Methods API
  version: 1.0.0
extends: openapi/leadping-payment-methods-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: 6
- target: $.paths['/payment-methods'].get
  update:
    x-apievangelist-phrasing:
      intent: List payment methods
      effect: read
      questions:
      - What payment methods does my organization have on file?
      - Which cards can fund my wallet?
      instructions:
      - text: List my organization's payment methods.
      - text: Show all cards on file.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/payment-methods/invoices'].get
  update:
    x-apievangelist-phrasing:
      intent: List invoices
      effect: read
      questions:
      - Where can I see my past invoices and whether they were paid?
      - What billing periods have I been invoiced for?
      instructions:
      - text: List my organization's invoices.
      - text: Show my billing invoices with amounts and payment status.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/payment-methods/invoices/{invoiceId}/pdf-access'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a link to an invoice PDF
      effect: read
      questions:
      - How do I download a PDF copy of an invoice?
      - Can I get a temporary link to view an invoice?
      instructions:
      - text: Get a PDF link for invoice {invoiceId}.
        slots:
          invoiceId: path.invoiceId
      - text: Give me a link for invoice {invoiceId} with download={download} so it saves as a file.
        slots:
          invoiceId: path.invoiceId
          download: query.download
      method: generated
      generated: '2026-10-01'
- target: $.paths['/payment-methods/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a payment method
      effect: read
      questions:
      - How do I see the card details of one payment method?
      - Which card is behind a specific payment method?
      instructions:
      - text: Show payment method {id}.
        slots:
          id: path.id
      - text: Get card details for payment method {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/payment-methods/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a payment method
      effect: destructive
      questions:
      - How do I remove an old card from my account?
      - Can a deleted card still be used for wallet funding?
      instructions:
      - text: Delete payment method {id}.
        slots:
          id: path.id
      - text: Remove card {id} from billing.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/payment-methods/{id}/default'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the default payment method
      effect: write
      questions:
      - How do I choose which card pays future invoices?
      - Can I switch my default payment method?
      instructions:
      - text: Make payment method {id} the default.
        slots:
          id: path.id
      - text: Use card {id} for future invoices.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'