# 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 Defender EASM Discovery Templates API
  version: 1.0.0
extends: openapi/microsoft-azure-discovery-templates-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: 2
- target: $.paths['/discoTemplates'].get
  update:
    x-apievangelist-phrasing:
      intent: Search discovery templates
      effect: read
      questions:
      - Which discovery templates are available to seed my attack surface discovery?
      - Can I filter discovery templates by name or page through them?
      instructions:
      - text: List discovery templates using API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Find discovery templates matching {filter}, {maxpagesize} per page.
        slots:
          filter: query.filter
          maxpagesize: query.maxpagesize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/discoTemplates/{templateId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a discovery template
      effect: read
      questions:
      - What seeds and names does a particular discovery template contain?
      - How do I look up one discovery template by its id?
      instructions:
      - text: Get discovery template {templateId}.
        slots:
          templateId: path.templateId
      - text: Show the seeds defined in discovery template {templateId}.
        slots:
          templateId: path.templateId
      method: generated
      generated: '2026-09-26'