API Evangelist conversational phrasing for WSO2 API Manager - Admin Key Manager (Collection) API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WSO2 API Manager - Admin Key Manager (Collection) API
  version: 1.0.0
extends: openapi/wso2-key-manager-collection-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/key-managers'].get
  update:
    x-apievangelist-phrasing:
      intent: List key managers
      effect: read
      questions:
      - Which key managers are configured to issue tokens?
      - What identity providers can my APIs use as key managers?
      instructions:
      - text: List all key managers.
      - text: Show the configured token key managers.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/key-managers'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a new key manager
      effect: write
      questions:
      - Can I register a new identity provider as a key manager?
      - What do I need to provide to add a key manager of a given type?
      instructions:
      - text: Add a key manager named {name} of type {type}.
        slots:
          name: requestBody.name
          type: requestBody.type
      - text: Register key manager {name} ({type}) with well-known endpoint {wellKnownEndpoint}.
        slots:
          name: requestBody.name
          type: requestBody.type
          wellKnownEndpoint: requestBody.wellKnownEndpoint
      method: generated
      generated: '2026-10-01'
- target: $.paths['/key-managers/discover'].post
  update:
    x-apievangelist-phrasing:
      intent: Discover key manager settings from a URL
      effect: read
      questions:
      - Can I pull endpoint settings from an identity provider's well-known URL?
      - Is there a way to auto-fill key manager details from a discovery endpoint?
      instructions:
      - text: Read the well-known configuration at {url}.
        slots:
          url: requestBody.url
      - text: Discover {type} key manager settings from {url}.
        slots:
          type: requestBody.type
          url: requestBody.url
      method: generated
      generated: '2026-10-01'