API Evangelist conversational phrasing for Token.io's Open Banking API for TPPs Authentication keys 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 Authentication keys API
  version: 1.0.0
extends: openapi/token-io-authentication-keys-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['/member/{memberId}/keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List a member's public authentication keys
      effect: read
      questions:
      - Which public keys are registered for authenticating a member?
      - Can I see every signing key a Token.io member has on file?
      instructions:
      - text: List all public keys for member {member_id}.
        slots:
          member_id: path.memberId
      - text: Show the authentication keys registered to member {member_id}.
        slots:
          member_id: path.memberId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/{memberId}/keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a public key for a member
      effect: write
      questions:
      - How do I upload a new public key so a member can authenticate API calls?
      - Which key algorithms can I specify when submitting a public key?
      instructions:
      - text: Add public key {public_key} to member {member_id}.
        slots:
          public_key: requestBody.publicKey
          member_id: path.memberId
      - text: Submit {algorithm} public key {public_key} for member {member_id}.
        slots:
          algorithm: requestBody.keyAlgorithm
          public_key: requestBody.publicKey
          member_id: path.memberId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/{memberId}/keys/{keyId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of a member's public keys
      effect: read
      questions:
      - Can I fetch the details of one specific public key by its key id?
      - What algorithm and value does a given member key have?
      instructions:
      - text: Get public key {key_id} for member {member_id}.
        slots:
          key_id: path.keyId
          member_id: path.memberId
      - text: Show key {key_id} belonging to member {member_id}.
        slots:
          key_id: path.keyId
          member_id: path.memberId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/{memberId}/keys/{keyId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a member's public key
      effect: destructive
      questions:
      - Can I remove a compromised public key from a member?
      - What's needed to retire an old authentication key?
      instructions:
      - text: Delete public key {key_id} from member {member_id}.
        slots:
          key_id: path.keyId
          member_id: path.memberId
      - text: Revoke member {member_id}'s key {key_id}.
        slots:
          member_id: path.memberId
          key_id: path.keyId
      method: generated
      generated: '2026-09-26'