API Evangelist conversational phrasing for Token Io Refunds API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Token Io Refunds API
  version: 1.0.0
extends: openapi/token-io-refunds-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/refunds'].get
  update:
    x-apievangelist-phrasing:
      intent: List refunds
      effect: read
      questions:
      - Which refunds have I issued this month?
      - Can I filter refunds by status or show only partial ones?
      instructions:
      - text: List {limit} refunds from {start_date} to {end_date}.
        slots:
          limit: query.limit
          start_date: query.startDate
          end_date: query.endDate
      - text: Show {limit} refunds with statuses {statuses}.
        slots:
          limit: query.limit
          statuses: query.statuses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/refunds'].post
  update:
    x-apievangelist-phrasing:
      intent: Refund a payment
      effect: write
      questions:
      - How do I refund a customer who paid by bank?
      - Is the debtor account optional when I've registered one for refunds?
      instructions:
      - text: Initiate a refund {initiation}.
        slots:
          initiation: requestBody.initiation
      - text: Refund the original transfer using initiation {initiation}.
        slots:
          initiation: requestBody.initiation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/refunds/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a refund
      effect: read
      questions:
      - What's the status of a specific refund?
      - Can I look up a refund by its id?
      instructions:
      - text: Get refund {refund_id}.
        slots:
          refund_id: path.id
      - text: Check whether refund {refund_id} has settled.
        slots:
          refund_id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/transfers/{id}/refunds'].get
  update:
    x-apievangelist-phrasing:
      intent: List refunds for a transfer
      effect: read
      questions:
      - Which refunds were made against one original payment?
      - Can I see all refunds tied to a transfer id?
      instructions:
      - text: List {limit} refunds for transfer {transfer_id}.
        slots:
          limit: query.limit
          transfer_id: path.id
      - text: Show refunds issued against transfer {transfer_id}, {limit} at a time.
        slots:
          transfer_id: path.id
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/refund/registrations'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a debtor account for refund processing
      effect: write
      questions:
      - Can I register the account refunds are paid from so I don't pass the debtor each time?
      - Where are extra bank credentials for refunds stored?
      instructions:
      - text: Register my debtor account for refunds.
      - text: Create a refund registration for my debtor account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/refund/registrations/{registrationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get refund registration information
      effect: read
      questions:
      - What refund registration information do I have on file?
      - Can I retrieve a refund registration by its id?
      instructions:
      - text: Get refund registration {registration_id}.
        slots:
          registration_id: path.registrationId
      - text: Show the debtor account registered under {registration_id}.
        slots:
          registration_id: path.registrationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/refund/registrations/{registrationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete refund registration information
      effect: destructive
      questions:
      - Can I delete a refund registration I set up?
      - What's removed when I delete a refund registration?
      instructions:
      - text: Delete refund registration {registration_id}.
        slots:
          registration_id: path.registrationId
      - text: Remove the refund debtor registration {registration_id}.
        slots:
          registration_id: path.registrationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/refunds/signature'].post
  update:
    x-apievangelist-phrasing:
      intent: Build the payload to sign for a refund
      effect: read
      questions:
      - Which payload do I need to sign before submitting a refund?
      - Does generating the refund signing payload create a refund?
      instructions:
      - text: Build the signing payload for refund initiation {initiation}.
        slots:
          initiation: requestBody.initiation
      - text: Get the provider payload I must sign for refund {initiation}.
        slots:
          initiation: requestBody.initiation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/upload/key-and-certificate'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a private key and certificate
      effect: write
      questions:
      - Where do I upload the key and certificate used for refund signing?
      - Can I upload a private key together with its certificate?
      instructions:
      - text: Upload private key and certificate {upload}.
        slots:
          upload: requestBody.upload
      - text: Store my signing key and certificate {upload}.
        slots:
          upload: requestBody.upload
      method: generated
      generated: '2026-09-26'
- target: $.paths['/refunds/{refundId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a refund by refund id (gateway)
      effect: read
      questions:
      - Is there a gateway endpoint to fetch a refund by refundId?
      - Can I read a refund through the gateway service path?
      instructions:
      - text: Get refund {refund_id} through the gateway service.
        slots:
          refund_id: path.refundId
      - text: Fetch the gateway record for refund {refund_id}.
        slots:
          refund_id: path.refundId
      method: generated
      generated: '2026-09-26'