# 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 Other Users API
  version: 1.0.0
extends: openapi/palo-alto-networks-other-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: 6
- target: $.paths['/insights/v3.0/resource/query/other/risky_user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count risky users
      effect: read
      questions:
      - How many risky users does Prisma Access see right now?
      - Can I narrow the risky user count with a filter such as a time range?
      instructions:
      - text: Count risky users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the number of risky users matching {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/other/active_user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count active users
      effect: read
      questions:
      - What is the total number of active users connected at the moment?
      - Can the active user count be filtered by location or connection type?
      instructions:
      - text: Count active users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Return the active user total for filter {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/other/active_user_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List active users with connection details
      effect: read
      questions:
      - Which users are active and how are they connected?
      - Can I see connection details for every currently active user?
      instructions:
      - text: List active users with their connection details in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show active users matching {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/other/session_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List user sessions
      effect: read
      questions:
      - What sessions have users opened through Prisma Access?
      - Can I pull a list of user sessions for a specific time window?
      instructions:
      - text: List user sessions in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get sessions matching {filter} for region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/other/user_count_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Get user count over time
      effect: read
      questions:
      - How has the number of users changed over time as a histogram?
      - Can I chart user counts across a time range?
      instructions:
      - text: Get the user count histogram for region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Build a user count histogram using {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/other/user_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List internal users
      effect: read
      questions:
      - Who are the internal users seen by Prisma Access Insights?
      - Is there a way to list internal users rather than only active ones?
      instructions:
      - text: List internal users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show internal users matching {filter} in region {region}.
        slots:
          filter: requestBody.filter
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'