API Evangelist conversational phrasing for Token Io Transfers 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 Transfers API
  version: 1.0.0
extends: openapi/token-io-transfers-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: 8
- target: $.paths['/transfers'].get
  update:
    x-apievangelist-phrasing:
      intent: List transfers
      effect: read
      questions:
      - Which transfers were made under a particular token?
      - Can I filter transfers by transaction status or refund status?
      instructions:
      - text: List transfers for token {token_id}.
        slots:
          token_id: query.tokenId
      - text: Show transfers with status {status}.
        slots:
          status: query.filter.transactionStatus
      method: generated
      generated: '2026-09-26'
- target: $.paths['/transfers'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a transaction for a transfer as the bank
      effect: write
      questions:
      - As the bank integration, how do I create a transaction for a transfer request?
      - What amount and source are required to execute a transfer?
      instructions:
      - text: Create transfer {transfer_id} for {amount} from source {source}.
        slots:
          transfer_id: requestBody.transferId
          amount: requestBody.transactionAmount
          source: requestBody.source
      - text: Execute transfer {transfer_id} of {amount} from {source} to {destinations}.
        slots:
          transfer_id: requestBody.transferId
          amount: requestBody.transactionAmount
          source: requestBody.source
          destinations: requestBody.destinations
      method: generated
      generated: '2026-09-26'
- target: $.paths['/transfers/{transferId}/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a transfer's status as the bank
      effect: read
      questions:
      - What's the bank-side status of a transfer?
      - Can I check a transfer's status by its unique id?
      instructions:
      - text: Get the status of transfer {transfer_id}.
        slots:
          transfer_id: path.transferId
      - text: Check transfer {transfer_id}'s status under consent {consent_id}.
        slots:
          transfer_id: path.transferId
          consent_id: header.token-consent-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/transfers/{paymentId}/refunds'].get
  update:
    x-apievangelist-phrasing:
      intent: List refunds for a payment
      effect: read
      questions:
      - Which refunds have been issued against a payment?
      - Can I page through refunds for one payment id?
      instructions:
      - text: List refunds for payment {payment_id}.
        slots:
          payment_id: path.paymentId
      - text: Show {limit} refunds made against payment {payment_id}.
        slots:
          limit: query.limit
          payment_id: path.paymentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/standing-order-submissions'].get
  update:
    x-apievangelist-phrasing:
      intent: List standing order submissions
      effect: read
      questions:
      - Which standing order submissions have I made?
      - Can I filter standing order submissions by status?
      instructions:
      - text: List my standing order submissions.
      - text: Show standing order submissions with status {status}.
        slots:
          status: query.filter.submissionStatus
      method: generated
      generated: '2026-09-26'
- target: $.paths['/standing-order-submissions'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a standing order
      effect: write
      questions:
      - How do I create a standing order using a token?
      - Can I set up a recurring standing order payment from an authorized token?
      instructions:
      - text: Create a standing order from token {token_id}.
        slots:
          token_id: requestBody.tokenId
      - text: Submit a standing order request for token {token_id}.
        slots:
          token_id: requestBody.tokenId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/standing-order-submissions/{submissionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a standing order submission
      effect: read
      questions:
      - Did my standing order submission go through?
      - Can I look up a standing order submission by id?
      instructions:
      - text: Get standing order submission {submission_id}.
        slots:
          submission_id: path.submissionId
      - text: Check the status of standing order submission {submission_id}.
        slots:
          submission_id: path.submissionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/transfers/{transferId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a transfer
      effect: read
      questions:
      - What are the details of one transfer?
      - Can I read a transfer without refreshing its status from the bank?
      instructions:
      - text: Get transfer {transfer_id}.
        slots:
          transfer_id: path.transferId
      - text: Show transfer {transfer_id} with skip update {skip}.
        slots:
          transfer_id: path.transferId
          skip: query.skipTransferUpdate
      method: generated
      generated: '2026-09-26'