# 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 Application API
  version: 1.0.0
extends: openapi/palo-alto-networks-application-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: 36
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/accelerated_application_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List accelerated applications
      effect: read
      questions:
      - Which of my Prisma Access applications are being accelerated right now?
      - Can I get a summary row for every accelerated application in my tenant?
      instructions:
      - text: List the accelerated applications for my tenant in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show accelerated apps with their summary details, filtered by {filter}, in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/accelerated_applications/throughput_before_after_boost_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart throughput before and after acceleration boost
      effect: read
      questions:
      - How much did acceleration boost throughput compared to before it was applied?
      - Is there a histogram comparing pre-boost and post-boost throughput for accelerated apps?
      instructions:
      - text: Plot accelerated app throughput before versus after boost in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Build a before-and-after boost throughput histogram with bucket settings {histogram} in {region}.
        slots:
          region: header.X-PANW-Region
          histogram: requestBody.histogram
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/applications_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count accelerated applications
      effect: read
      questions:
      - What's the total number of apps that have acceleration turned on?
      - Can I get just a count of accelerated applications rather than the full list?
      instructions:
      - text: Count my accelerated applications in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Tell me how many apps are accelerated for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/better_response_time'].post
  update:
    x-apievangelist-phrasing:
      intent: Get response time data for accelerated apps
      effect: read
      questions:
      - Are accelerated applications actually responding faster?
      - What response time figures exist for the apps I've accelerated?
      instructions:
      - text: Show response time data for accelerated applications in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Report which accelerated apps got better response times, filtered by {filter}, in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/data_transfer_throughput_per_app'].post
  update:
    x-apievangelist-phrasing:
      intent: Get transfer and throughput per accelerated app
      effect: read
      questions:
      - Which accelerated application moves the most data and at what throughput?
      - Can I see data transfer alongside throughput, app by app, for accelerated traffic?
      instructions:
      - text: Break down data transfer and throughput per accelerated application in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get per-app transfer and throughput numbers for accelerated apps matching {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/packet_loss_per_app_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart packet loss per accelerated application
      effect: read
      questions:
      - Which accelerated apps are dropping packets, and when?
      - Is there a packet loss histogram for individual accelerated applications?
      instructions:
      - text: Plot packet loss per accelerated app in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Chart per-application packet loss with bucket settings {histogram} in {region}.
        slots:
          region: header.X-PANW-Region
          histogram: requestBody.histogram
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/performance_boost'].post
  update:
    x-apievangelist-phrasing:
      intent: Get acceleration performance boost metrics
      effect: read
      questions:
      - What performance boost is acceleration delivering for my applications?
      - How big an improvement is app acceleration giving overall?
      instructions:
      - text: Show the performance boost metrics for accelerated applications in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Report acceleration performance gains for apps matching {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/rtt_variance_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart RTT variance for accelerated apps
      effect: read
      questions:
      - How much does round-trip time vary for accelerated applications?
      - Can I see RTT variance for accelerated traffic as a histogram?
      instructions:
      - text: Plot RTT variance for accelerated applications in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Build an RTT variance histogram with bucket settings {histogram} in {region}.
        slots:
          region: header.X-PANW-Region
          histogram: requestBody.histogram
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/throughput_per_app_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart throughput per accelerated application
      effect: read
      questions:
      - What does throughput look like over time for each accelerated app?
      - Can I get a per-application throughput histogram, not the before/after boost comparison?
      instructions:
      - text: Plot throughput over time for each accelerated application in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Chart per-app throughput for accelerated apps using bucket settings {histogram} in {region}.
        slots:
          region: header.X-PANW-Region
          histogram: requestBody.histogram
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/total_data_transfer'].post
  update:
    x-apievangelist-phrasing:
      intent: Get total data moved by accelerated apps
      effect: read
      questions:
      - How much data in total have my accelerated applications transferred?
      - What's the average total bytes moved by accelerated apps?
      instructions:
      - text: Get total data transfer for accelerated applications in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Report total and average bytes for accelerated apps matching {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/accelerated_applications/users_count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count users of accelerated applications
      effect: read
      questions:
      - How many people are using accelerated applications?
      - What's the user count behind my accelerated apps?
      instructions:
      - text: Count the users of accelerated applications in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Give me the accelerated-app user count for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/app_details_bw_info_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart application bandwidth usage
      effect: read
      questions:
      - How much upload and download bandwidth are my applications consuming over time?
      - Where can I see total bandwidth for an application as a histogram?
      instructions:
      - text: Plot application bandwidth usage, total, upload and download, in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Chart app bandwidth for applications matching {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/accelerated_applications/response_time_before_and_after_improvement'].post
  update:
    x-apievangelist-phrasing:
      intent: Compare response times before and after acceleration
      effect: read
      questions:
      - What were response times before acceleration compared with after, across all accelerated apps?
      - Can I chart the overall response time improvement acceleration gave me?
      instructions:
      - text: Compare response time before and after improvement for all accelerated apps in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Chart overall before-and-after response time using bucket settings {histogram} in {region}.
        slots:
          region: header.X-PANW-Region
          histogram: requestBody.histogram
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/accelerated_applications/response_time_before_and_after_improvement_per_app'].post
  update:
    x-apievangelist-phrasing:
      intent: Compare one app's response time improvement
      effect: read
      questions:
      - Did response time improve for one particular accelerated application?
      - Where do I see before and after response times for a single app?
      instructions:
      - text: Show before and after response times for the accelerated app picked by {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      - text: Chart one application's response time improvement with bucket settings {histogram} in {region}.
        slots:
          region: header.X-PANW-Region
          histogram: requestBody.histogram
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/app_info'].post
  update:
    x-apievangelist-phrasing:
      intent: Get detailed application information
      effect: read
      questions:
      - What threats and traffic details are recorded for a given application?
      - Can I pull the full detail view for an application, threat info included?
      instructions:
      - text: Get detailed application info, threats and traffic included, for {filter} in region {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      - text: Show traffic and threat details for my applications in {region}.
        slots:
          region: header.X-PANW-Region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/internal/app_by_risk_score'].post
  update:
    x-apievangelist-phrasing:
      intent: Group applications by risk score
      effect: read
      questions:
      - Which applications on my network carry the highest risk scores?
      - How many apps fall into each risk score level?
      instructions:
      - text: Show application counts by risk score in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Break down apps by risk score for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/internal/app_by_tag'].post
  update:
    x-apievangelist-phrasing:
      intent: Group applications by tag
      effect: read
      questions:
      - How many applications carry each tag, and what sub types are they?
      - Can I group the apps seen on my network by tag?
      instructions:
      - text: Group applications by tag with counts in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show apps by tag and sub type matching {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/internal/application_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List applications with metrics and threats
      effect: read
      questions:
      - What applications are in use on my network, with their metrics and threats?
      - Can I get the full list of applications seen, not only accelerated ones?
      instructions:
      - text: List all applications with their metrics and threat info in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: List applications matching {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/internal/total_data_transfer_application'].post
  update:
    x-apievangelist-phrasing:
      intent: Get total data transfer per application
      effect: read
      questions:
      - Which applications are using the most data, and what category is each?
      - What's the total data usage for each application on my network?
      instructions:
      - text: Rank applications by total data transfer in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Get per-application data usage and category for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/internal/total_data_transfer_by_destination'].post
  update:
    x-apievangelist-phrasing:
      intent: Get total data transfer by destination
      effect: read
      questions:
      - Which destinations are receiving the most traffic from my users?
      - What are the total bytes sent to each destination?
      instructions:
      - text: Break down total data transfer by destination in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show bytes per destination for traffic matching {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/pab/access_events'].post
  update:
    x-apievangelist-phrasing:
      intent: Count browser access events
      effect: read
      questions:
      - How many Prisma Access Browser access events happened?
      - What's the total count of browser events in the access classification category?
      instructions:
      - text: Count every browser access event in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Tally access-classified browser events for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/pab/access_events_breakdown'].post
  update:
    x-apievangelist-phrasing:
      intent: Break down browser access events by type
      effect: read
      questions:
      - What kinds of browser access events are occurring and how many of each?
      - Can I split access classification events by event type?
      instructions:
      - text: Split all browser access events by type in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show access event counts per type, blocked or allowed, for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/pab/access_events_breakdown_blocked_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart blocked access events by type over time
      effect: read
      questions:
      - How have blocked browser access events trended over time, split by type?
      - Is there a per-type histogram of blocked access events?
      instructions:
      - text: Plot blocked browser access events per type across time in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Chart the blocked access event type split with bucket settings {histogram} in {region}.
        slots:
          region: header.X-PANW-Region
          histogram: requestBody.histogram
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/applications/pab/data_events'].post
  update:
    x-apievangelist-phrasing:
      intent: Count browser data events
      effect: read
      questions:
      - How many data-classified events did Prisma Access Browser record?
      - What's the total number of browser events touching sensitive data?
      instructions:
      - text: Give me the data classification event total in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Tally data-classified browser activity for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/access_events_blocked'].post
  update:
    x-apievangelist-phrasing:
      intent: Count blocked browser access events
      effect: read
      questions:
      - How many browser access events were blocked?
      - What's the total of blocked events in the access classification category?
      instructions:
      - text: Count the blocked browser access events in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Total up blocked access-classified events for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/access_events_blocked_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart blocked browser access events over time
      effect: read
      questions:
      - When during the period were browser access events being blocked?
      - Can I see blocked access events as a timeline without the per-type split?
      instructions:
      - text: Plot the blocked browser access event totals over time in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show a timeline of blocked access events for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/access_events_breakdown_blocked'].post
  update:
    x-apievangelist-phrasing:
      intent: Break down blocked access events by type
      effect: read
      questions:
      - Which types of browser access events get blocked most often?
      - Can I get blocked access event counts for each event type?
      instructions:
      - text: Split blocked browser access events by type in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show blocked access event counts per type for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/access_events_breakdown_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart access events by type over time
      effect: read
      questions:
      - How has each type of browser access event trended over time, blocked or not?
      - Is there a histogram of all access events split by type?
      instructions:
      - text: Plot all browser access events per type across time in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Chart the access event type mix over time for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/access_events_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart browser access events over time
      effect: read
      questions:
      - How many browser access events happen in each interval across the period?
      - Can I see access classification event volume as a histogram?
      instructions:
      - text: Plot overall browser access event volume over time in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show a timeline of access event volume for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/data_events_blocked'].post
  update:
    x-apievangelist-phrasing:
      intent: Count blocked browser data events
      effect: read
      questions:
      - How many data classification events ended up blocked?
      - What number of sensitive-data browser actions were stopped?
      instructions:
      - text: Give me the number of blocked data classification events in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Count only the blocked sensitive-data browser actions for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/data_events_blocked_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart blocked browser data events over time
      effect: read
      questions:
      - When were sensitive-data browser actions being blocked across the period?
      - Can I see blocked data classification events as a timeline, without a type split?
      instructions:
      - text: Graph stopped data classification events across time in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Timeline the blocked data-classified browser activity for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/data_events_breakdown'].post
  update:
    x-apievangelist-phrasing:
      intent: Break down browser data events by type
      effect: read
      questions:
      - What kinds of data classification events occur and how often each?
      - Can I split sensitive-data browser events by event type?
      instructions:
      - text: Divide data classification events into types in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show counts per data event type, blocked and allowed, for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/data_events_breakdown_blocked'].post
  update:
    x-apievangelist-phrasing:
      intent: Break down blocked data events by type
      effect: read
      questions:
      - Which types of data classification events get blocked most?
      - Can I see blocked sensitive-data events counted per type?
      instructions:
      - text: Divide the stopped data classification events into types in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Show blocked data event counts for each type for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/data_events_breakdown_blocked_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart blocked data events by type over time
      effect: read
      questions:
      - How have blocked data classification events trended over time per type?
      - Is there a histogram of blocked sensitive-data events split by type?
      instructions:
      - text: Graph stopped data classification events per type across time in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Chart the per-type trend of blocked data-classified events for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/data_events_breakdown_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart data events by type over time
      effect: read
      questions:
      - How has each type of data classification event trended, blocked or not?
      - Is there a histogram of all sensitive-data browser events broken out by type?
      instructions:
      - text: Graph every data classification event type across time in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Chart the data event type mix over time for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/v3.0/resource/query/pab/data_events_histogram'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart browser data events over time
      effect: read
      questions:
      - How many data classification events happen in each interval of the period?
      - Can I see overall sensitive-data browser event volume as a timeline?
      instructions:
      - text: Graph overall data classification event volume across time in region {region}.
        slots:
          region: header.X-PANW-Region
      - text: Timeline data-classified browser event volume for {filter} in {region}.
        slots:
          region: header.X-PANW-Region
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'