API Evangelist conversational phrasing for Token.io's Open Banking API for TPPs Requests - for Payments v1 or AIS 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's Open Banking API for TPPs Requests - for Payments v1 or AIS API
  version: 1.0.0
extends: openapi/token-io-requests-for-payments-v1-or-ais-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: 4
- target: $.paths['/token-requests'].post
  update:
    x-apievangelist-phrasing:
      intent: Initiate a token request for payments v1 or AIS
      effect: write
      questions:
      - How do I start an AIS or v1 payment request using Token.io Hosted Pages?
      - What's required in a token request payload?
      instructions:
      - text: Initiate a token request with payload {payload}.
        slots:
          payload: requestBody.requestPayload
      - text: Start a hosted-pages token request with payload {payload} and options {options}.
        slots:
          payload: requestBody.requestPayload
          options: requestBody.requestOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/token-requests/{requestId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a token request
      effect: read
      questions:
      - Can I retrieve a token request by its id?
      - What details does a stored token request hold?
      instructions:
      - text: Get token request {request_id}.
        slots:
          request_id: path.requestId
      - text: Show token request {request_id}.
        slots:
          request_id: path.requestId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/token-requests/{tokenRequestId}/result'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a token request result
      effect: read
      questions:
      - Has my token request moved from PENDING to PROCESSED?
      - Can I find out if a token request was rejected?
      instructions:
      - text: Get the result of token request {token_request_id}.
        slots:
          token_request_id: path.tokenRequestId
      - text: Check whether token request {token_request_id} is processed.
        slots:
          token_request_id: path.tokenRequestId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/token-requests/{tokenRequestId}/authorization'].post
  update:
    x-apievangelist-phrasing:
      intent: Initiate bank authorization for a token request
      effect: write
      questions:
      - How do I start the bank authorization step for a token request?
      - Can I use a credentials flow instead of redirecting to the bank?
      instructions:
      - text: Initiate bank authorization for token request {token_request_id}.
        slots:
          token_request_id: path.tokenRequestId
      - text: Start bank authorization for {token_request_id} with credentials {credentials}.
        slots:
          token_request_id: path.tokenRequestId
          credentials: requestBody.credentials
      method: generated
      generated: '2026-09-26'