# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure QnAMaker Client Endpoint Keys API
  version: 1.0.0
extends: openapi/microsoft-azure-endpointkeys-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: 3
- target: $.paths['/endpointSettings'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update QnA Maker endpoint settings
      effect: write
      questions:
      - How do I change the runtime endpoint settings of my QnA Maker resource?
      - Can I update QnA Maker endpoint settings such as active learning in one call?
      instructions:
      - text: Update the QnA Maker endpoint settings to {endpointSettingsPayload}.
        slots:
          endpointSettingsPayload: body.endpointSettingsPayload
      - text: Apply new endpoint settings {endpointSettingsPayload} to my QnA Maker endpoint.
        slots:
          endpointSettingsPayload: body.endpointSettingsPayload
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpointkeys/{keyType}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a QnA Maker endpoint key
      effect: write
      questions:
      - How do I rotate the primary or secondary key of my QnA Maker endpoint?
      - Can I regenerate just one QnA Maker endpoint key at a time?
      instructions:
      - text: Regenerate the {keyType} QnA Maker endpoint key.
        slots:
          keyType: path.keyType
      - text: Rotate endpoint key {keyType} for my knowledge base runtime.
        slots:
          keyType: path.keyType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpointkeys'].get
  update:
    x-apievangelist-phrasing:
      intent: Get QnA Maker endpoint keys
      effect: read
      questions:
      - Where do I find the endpoint keys my app uses to query a QnA Maker knowledge base?
      - What are the current primary and secondary QnA Maker endpoint keys?
      instructions:
      - text: Get my QnA Maker endpoint keys.
      - text: Show the current endpoint keys for the QnA Maker runtime.
      method: generated
      generated: '2026-09-26'