# 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 Users API
  version: 1.0.0
extends: openapi/palo-alto-networks-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/users/agent/connected_user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count users connected via agent
      effect: read
      questions:
      - How many users are connected through the endpoint agent?
      - What's the count of agent-connected users for my tenant?
      instructions:
      - text: Count agent-connected users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the agent connected user count in {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/agentless/connected_user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count agentless proxy users
      effect: read
      questions:
      - How many users are connected via the agentless proxy?
      - Can I count explicit proxy users who aren't running an agent?
      instructions:
      - text: Count agentless proxy users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the agentless connected user count in {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/all/user_list_all'].post
  update:
    x-apievangelist-phrasing:
      intent: List all users with details
      effect: read
      questions:
      - Can I get a detailed list of every user across all connection types?
      - Where do I find all users with their details in Prisma Access Insights?
      instructions:
      - text: List all users with details in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the full user list in {region} matching {filter}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/users/branch/connected_user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count branch-connected users
      effect: read
      questions:
      - How many users are connected from branch sites?
      - What's the connected user count for remote networks?
      instructions:
      - text: Count branch connected users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the branch connected user count in {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/eb/connected_user_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count Enterprise Browser users
      effect: read
      questions:
      - How many users are connected through Enterprise Browser?
      - Can I track Enterprise Browser adoption by connected user count?
      instructions:
      - text: Count Enterprise Browser connected users in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the Enterprise Browser user count in {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/other/connected_entity_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count connected users on other hosts
      effect: read
      questions:
      - How many users are connected from other hosts?
      - Is there a count for users outside agent, branch and browser connections?
      instructions:
      - text: Count connected users for other hosts in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get the other-hosts connected count in {region} with filter {filter}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'