API Evangelist conversational phrasing for Token Info 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 Info API
  version: 1.0.0
extends: openapi/token-io-info-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: 5
- target: $.paths['/bank/countries'].get
  update:
    x-apievangelist-phrasing:
      intent: List countries with integrated banks
      effect: read
      questions:
      - In which countries does Token.io have integrated banks?
      - Can I list only countries where banks support guest checkout?
      instructions:
      - text: List countries that have integrated banks.
      - text: Show countries with banks from providers {providers}.
        slots:
          providers: query.providers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/banks'].get
  update:
    x-apievangelist-phrasing:
      intent: Find banks matching feature criteria
      effect: read
      questions:
      - Which banks in a country support standing orders?
      - Can I find banks by name, BIC or the SCA methods they use?
      instructions:
      - text: Find banks in countries {countries}.
        slots:
          countries: query.countries
      - text: Search banks for {search} using SCA methods {sca_methods}.
        slots:
          search: query.search
          sca_methods: query.scaMethods
      method: generated
      generated: '2026-09-26'
- target: $.paths['/banks/{bankId}/info'].get
  update:
    x-apievangelist-phrasing:
      intent: Get information about one bank
      effect: read
      questions:
      - What does Token.io know about a specific supported bank?
      - Can I look up a single bank's details by bank id?
      instructions:
      - text: Get information about bank {bank_id}.
        slots:
          bank_id: path.bankId
      - text: Show the profile of bank {bank_id}.
        slots:
          bank_id: path.bankId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/banks/{bankId}/token-requests/{tokenRequestId}/urls'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a bank authorization URL for a token request
      effect: write
      questions:
      - How do I get the URL to send a user to their bank for a token request?
      - Can I produce the bank redirect link once the user has accepted consent?
      instructions:
      - text: Generate the bank authorization URL for token request {token_request_id} at bank {bank_id}.
        slots:
          token_request_id: path.tokenRequestId
          bank_id: path.bankId
      - text: Produce the bank {bank_id} login link for token request {token_request_id} with consent accepted {accepted}.
        slots:
          bank_id: path.bankId
          token_request_id: path.tokenRequestId
          accepted: requestBody.consentAccepted
      method: generated
      generated: '2026-09-26'
- target: $.paths['/token-requests/{tokenRequestId}/authorization'].post
  update:
    x-apievangelist-phrasing:
      intent: Start bank authorization for a token request
      effect: write
      questions:
      - Can I kick off the bank authorization process directly for a token request?
      - Is there a credentials flow for authorizing with the bank instead of a redirect?
      instructions:
      - text: Initiate bank authorization for token request {token_request_id}.
        slots:
          token_request_id: path.tokenRequestId
      - text: Start authorization for token request {token_request_id} using credentials {credentials}.
        slots:
          token_request_id: path.tokenRequestId
          credentials: requestBody.credentials
      method: generated
      generated: '2026-09-26'