# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Method Payment Reversals API
  version: 1.0.0
extends: openapi/methodfi-payment-reversals-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['/payments/{paymentId}/reversals'].get
  update:
    x-apievangelist-phrasing:
      intent: List reversals for a payment
      effect: read
      questions:
      - Has this payment been reversed, and how many times?
      - Can I see all reversals tied to one payment?
      instructions:
      - text: List reversals for payment {payment}.
        slots:
          payment: path.paymentId
      - text: Show every reversal on payment {payment}.
        slots:
          payment: path.paymentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/payments/{paymentId}/reversals/{reversalId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one payment reversal
      effect: read
      questions:
      - Can I look up a specific reversal on a payment?
      - What's the status of one payment reversal?
      instructions:
      - text: Get reversal {reversal} on payment {payment}.
        slots:
          reversal: path.reversalId
          payment: path.paymentId
      - text: Check the status of reversal {reversal} for payment {payment}.
        slots:
          reversal: path.reversalId
          payment: path.paymentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/payments/{paymentId}/reversals/{reversalId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a payment reversal's status
      effect: write
      questions:
      - How do I update the status of a reversal?
      - Can I move a payment reversal to a new status?
      instructions:
      - text: Set reversal {reversal} on payment {payment} to {status}.
        slots:
          reversal: path.reversalId
          payment: path.paymentId
          status: requestBody.status
      - text: Update the status of reversal {reversal} for payment {payment}.
        slots:
          reversal: path.reversalId
          payment: path.paymentId
      method: generated
      generated: '2026-10-01'