# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Palo Alto Networks 3.0 Monitored Users API
  version: 1.0.0
extends: openapi/palo-alto-networks-monitored-users-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: 5
- target: $.paths['/insights/v3.0/resource/query/user/monitored/user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count monitored users
      effect: read
      questions:
      - How many users are currently being monitored in my Prisma Access tenant?
      - Can I filter the monitored user count, for example by a time range?
      instructions:
      - text: Get the number of monitored users for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Count monitored users in region {region} matching filter {filter}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/user/monitored/user_count_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a histogram of monitored users
      effect: read
      questions:
      - How has the number of monitored users changed over time?
      - Can I get monitored user counts bucketed as a histogram?
      instructions:
      - text: Get the monitored user histogram for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Chart monitored users over time in region {region} with filter {filter}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/monitored/device_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count monitored devices
      effect: read
      questions:
      - How many devices belonging to monitored users are being tracked?
      - Can I filter the monitored device count for a sub-tenant?
      instructions:
      - text: Get the number of monitored devices for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Count monitored devices in region {region} for tenant {tenant}.
        slots:
          region: header.X-PANW-Region
          tenant: header.Prisma-Tenant
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/monitored/device_count_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a histogram of monitored devices
      effect: read
      questions:
      - What does the trend of monitored device counts look like over time?
      - Can I get device counts as histogram buckets with a filter applied?
      instructions:
      - text: Get the monitored device histogram for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Chart monitored devices over time in region {region} with filter {filter}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/monitored/user_experience_score'].post
  update:
    x-apievangelist-phrasing:
      intent: Get user experience scores
      effect: read
      questions:
      - What experience scores are my monitored users getting?
      - Can I pull digital experience scores for users in one tenant?
      instructions:
      - text: Get user experience scores for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show experience scores in region {region} for users matching {filter}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'