# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Aggreagate Monitoring Insights Resources API
  version: 1.0.0
extends: openapi/palo-alto-networks-insights-resources-api-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: 1
- target: $.paths['/mt/monitor/v1/agg/upgrades/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List upgrades across tenants
      effect: read
      questions:
      - Which upgrades are scheduled or completed across my tenants?
      - Can I pick which upgrade properties come back in the aggregated list?
      instructions:
      - text: List upgrades across tenants matching {filter} with properties {properties}.
        slots:
          filter: requestBody.filter
          properties: requestBody.properties
      - text: Show aggregated tenant upgrades in region {X-PANW-Region} for filter {filter} and properties {properties}.
        slots:
          X-PANW-Region: header.X-PANW-Region
          filter: requestBody.filter
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'