# 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 Stats API
  version: 1.0.0
extends: openapi/palo-alto-networks-stats-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: 27
- target: $.paths['/api/v34.03/stats/app-firewall/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count app firewalls (v34.03)
      effect: read
      questions:
      - How many application firewalls are deployed according to the v34.03 stats endpoint?
      - Can the older v34.03 API give me a count of my app-embedded firewalls?
      instructions:
      - text: Get the application firewall count from the v34.03 stats API.
      - text: Using API version 34.03, tell me how many app firewalls we have.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/compliance'].get
  update:
    x-apievangelist-phrasing:
      intent: Get compliance stats (v34.03)
      effect: read
      questions:
      - What do my compliance statistics look like on the v34.03 API?
      - Can I filter v34.03 compliance stats by policy type or compliance category?
      - Which compliance rules are failing across my collections per the 34.03 stats endpoint?
      instructions:
      - text: Show v34.03 compliance stats for collection {collections}.
        slots:
          collections: query.collections
      - text: Pull 34.03 compliance statistics for cloud account {accountIDs} under policy type {policyType}.
        slots:
          accountIDs: query.accountIDs
          policyType: query.policyType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/compliance/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download compliance stats as a file (v34.03)
      effect: read
      questions:
      - Can I export compliance statistics to a file with the v34.03 API?
      - Is there a 34.03 download of compliance stats scoped to one rule name?
      instructions:
      - text: Download the v34.03 compliance stats report for rule {ruleName}.
        slots:
          ruleName: query.ruleName
      - text: Export 34.03 compliance statistics for compliance template {template} to a file.
        slots:
          template: query.template
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/compliance/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Recalculate compliance stats (v34.03)
      effect: write
      questions:
      - How do I force the v34.03 compliance statistics to recalculate?
      - Can I refresh 34.03 compliance stats for just one compliance category?
      instructions:
      - text: Refresh the compliance stats via the v34.03 API.
      - text: Trigger a 34.03 compliance stats refresh for collection {collections} and category {category}.
        slots:
          collections: query.collections
          category: query.category
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/daily'].get
  update:
    x-apievangelist-phrasing:
      intent: Get daily compliance trend (v34.03)
      effect: read
      questions:
      - Where can I see day-by-day compliance numbers on the v34.03 API?
      - Does the 34.03 stats API keep a daily history of compliance results?
      instructions:
      - text: Fetch the daily compliance stats from the v34.03 API.
      - text: Show me the per-day compliance trend using version 34.03.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/dashboard'].get
  update:
    x-apievangelist-phrasing:
      intent: Get dashboard summary stats (v34.03)
      effect: read
      questions:
      - What numbers feed the Compute dashboard on the v34.03 API?
      - Can I pull the dashboard summary widgets through the 34.03 stats endpoint?
      instructions:
      - text: Get the dashboard stats from the v34.03 API.
      - text: Pull the 34.03 dashboard overview numbers for my weekly report.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/events'].get
  update:
    x-apievangelist-phrasing:
      intent: Get runtime event stats (v34.03)
      effect: read
      questions:
      - How many security events were recorded in a time window on the v34.03 API?
      - Can I break down 34.03 event stats by MITRE attack technique?
      instructions:
      - text: Show v34.03 event stats from {from} to {to}.
        slots:
          from: query.from
          to: query.to
      - text: Get 34.03 event counts for attack technique {attackTechniques} in account {accountIDs}.
        slots:
          attackTechniques: query.attackTechniques
          accountIDs: query.accountIDs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/license'].get
  update:
    x-apievangelist-phrasing:
      intent: Get license usage stats (v34.03)
      effect: read
      questions:
      - How much of my license am I consuming according to the v34.03 stats API?
      - Where do I see license usage numbers on the older 34.03 endpoint?
      instructions:
      - text: Get license stats from the v34.03 API.
      - text: Check our license consumption using stats version 34.03.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/vulnerabilities'].get
  update:
    x-apievangelist-phrasing:
      intent: Get CVE vulnerability stats (v34.03)
      effect: read
      questions:
      - Which CVEs affect the most resources according to the v34.03 vulnerability stats?
      - Can I filter 34.03 vulnerability stats by CVSS score threshold?
      - Is there a way to see only critical CVEs in the v34.03 vulnerability summary?
      instructions:
      - text: Show v34.03 vulnerability stats for {cve}.
        slots:
          cve: query.cve
      - text: List 34.03 CVE stats with severity at or above {severityThreshold}, limited to {limit} rows.
        slots:
          severityThreshold: query.severityThreshold
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/vulnerabilities/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download CVE vulnerability stats (v34.03)
      effect: read
      questions:
      - Can I export the CVE statistics to a file on the v34.03 API?
      - How would I download 34.03 vulnerability stats filtered by resource type?
      instructions:
      - text: Download the v34.03 vulnerability stats file for resource type {resourceType}.
        slots:
          resourceType: query.resourceType
      - text: Export 34.03 CVE stats with CVSS above {cvssThreshold} to a file.
        slots:
          cvssThreshold: query.cvssThreshold
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/vulnerabilities/impacted-resources'].get
  update:
    x-apievangelist-phrasing:
      intent: Get resources impacted by a CVE (v34.03)
      effect: read
      questions:
      - Which images, hosts and functions are hit by a given CVE on the v34.03 API?
      - Can the 34.03 stats show impacted resources for a CVE in a specific package?
      instructions:
      - text: Show v34.03 impacted resources for {cve}.
        slots:
          cve: query.cve
      - text: List 34.03 resources impacted by {cve} in package {packages}.
        slots:
          cve: query.cve
          packages: query.packages
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/vulnerabilities/impacted-resources/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download resources impacted by a CVE (v34.03)
      effect: read
      questions:
      - Can I export the list of resources affected by one CVE using the v34.03 API?
      - Is there a 34.03 file download of CVE impacted resources with risk factors?
      instructions:
      - text: Download the v34.03 impacted-resources file for {cve}.
        slots:
          cve: query.cve
      - text: Export 34.03 resources impacted by {cve} that have risk factor {riskFactors}.
        slots:
          cve: query.cve
          riskFactors: query.riskFactors
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/stats/vulnerabilities/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Recalculate vulnerability stats (v34.03)
      effect: write
      questions:
      - How do I make the v34.03 CVE statistics recalculate after a new scan?
      - Can I trigger a vulnerability stats refresh on the older 34.03 API?
      instructions:
      - text: Refresh the vulnerability stats via the v34.03 API.
      - text: Recompute CVE stats using stats version 34.03.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/app-firewall/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count app firewalls (v34.04)
      effect: read
      questions:
      - How many application firewalls do I have according to the current v34.04 stats?
      - Can the v34.04 API return a count of app-embedded firewalls?
      instructions:
      - text: Get the application firewall count from the v34.04 stats API.
      - text: Using API version 34.04, tell me how many app firewalls are running.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/compliance'].get
  update:
    x-apievangelist-phrasing:
      intent: Get compliance stats (v34.04)
      effect: read
      questions:
      - What do my compliance statistics look like on the current v34.04 API?
      - Can I filter v34.04 compliance stats by compliance template like CIS or PCI?
      - Which rules are failing across my cloud accounts per the 34.04 compliance stats?
      instructions:
      - text: Show v34.04 compliance stats for collection {collections}.
        slots:
          collections: query.collections
      - text: Pull 34.04 compliance statistics for account {accountIDs} using template {template}.
        slots:
          accountIDs: query.accountIDs
          template: query.template
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/compliance/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download compliance stats as a file (v34.04)
      effect: read
      questions:
      - Can I export compliance statistics to a file with the current v34.04 API?
      - Is there a 34.04 download of compliance stats limited to one policy type?
      instructions:
      - text: Download the v34.04 compliance stats report for rule {ruleName}.
        slots:
          ruleName: query.ruleName
      - text: Export 34.04 compliance statistics for policy type {policyType} to a file.
        slots:
          policyType: query.policyType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/compliance/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Recalculate compliance stats (v34.04)
      effect: write
      questions:
      - How do I force compliance statistics to recalculate on the v34.04 API?
      - Can I refresh 34.04 compliance stats for a single cloud account?
      instructions:
      - text: Refresh the compliance stats via the v34.04 API.
      - text: Trigger a 34.04 compliance stats refresh for account {accountIDs}.
        slots:
          accountIDs: query.accountIDs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/daily'].get
  update:
    x-apievangelist-phrasing:
      intent: Get daily compliance trend (v34.04)
      effect: read
      questions:
      - Where can I see day-by-day compliance numbers on the current v34.04 API?
      - Does the 34.04 stats API return a daily compliance history?
      instructions:
      - text: Fetch the daily compliance stats from the v34.04 API.
      - text: Show me the per-day compliance trend using version 34.04.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/dashboard'].get
  update:
    x-apievangelist-phrasing:
      intent: Get dashboard summary stats (v34.04)
      effect: read
      questions:
      - What numbers feed the Compute dashboard on the current v34.04 API?
      - Can I pull dashboard summary widgets from the 34.04 stats endpoint?
      instructions:
      - text: Get the dashboard stats from the v34.04 API.
      - text: Pull the 34.04 dashboard overview numbers for today's review.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/events'].get
  update:
    x-apievangelist-phrasing:
      intent: Get runtime event stats (v34.04)
      effect: read
      questions:
      - How many security events happened in a date range on the current v34.04 API?
      - Can I filter 34.04 event stats by collection and attack technique?
      instructions:
      - text: Show v34.04 event stats from {from} to {to}.
        slots:
          from: query.from
          to: query.to
      - text: Get 34.04 event counts for collection {collections} and technique {attackTechniques}.
        slots:
          collections: query.collections
          attackTechniques: query.attackTechniques
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/license'].get
  update:
    x-apievangelist-phrasing:
      intent: Get license usage stats (v34.04)
      effect: read
      questions:
      - How much of my license am I using according to the current v34.04 stats?
      - Where does the 34.04 API report license consumption?
      instructions:
      - text: Get license stats from the v34.04 API.
      - text: Check license consumption using stats version 34.04.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/vulnerabilities'].get
  update:
    x-apievangelist-phrasing:
      intent: Get CVE vulnerability stats (v34.04)
      effect: read
      questions:
      - Which CVEs are most widespread according to the current v34.04 vulnerability stats?
      - Can I restrict 34.04 vulnerability stats to agentless scan results?
      - Is it possible to include stopped VMs in the v34.04 CVE summary?
      instructions:
      - text: Show v34.04 vulnerability stats for {cve}.
        slots:
          cve: query.cve
      - text: List 34.04 CVE stats with CVSS at or above {cvssThreshold}, sorted by {sort}.
        slots:
          cvssThreshold: query.cvssThreshold
          sort: query.sort
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/vulnerabilities/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download CVE vulnerability stats (v34.04)
      effect: read
      questions:
      - Can I export CVE statistics to a file on the current v34.04 API?
      - How would I download 34.04 vulnerability stats filtered by severity?
      instructions:
      - text: Download the v34.04 vulnerability stats file for resource type {resourceType}.
        slots:
          resourceType: query.resourceType
      - text: Export 34.04 CVE stats at severity {severityThreshold} or higher to a file.
        slots:
          severityThreshold: query.severityThreshold
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/vulnerabilities/impacted-resources'].get
  update:
    x-apievangelist-phrasing:
      intent: Get resources impacted by a CVE (v34.04)
      effect: read
      questions:
      - Which workloads are hit by a given CVE on the current v34.04 API?
      - Can the 34.04 stats show resources impacted by a CVE with environmental risk factors?
      instructions:
      - text: Show v34.04 impacted resources for {cve}.
        slots:
          cve: query.cve
      - text: List 34.04 resources impacted by {cve} with environment risk factor {envRiskFactors}.
        slots:
          cve: query.cve
          envRiskFactors: query.envRiskFactors
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/vulnerabilities/impacted-resources/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download resources impacted by a CVE (v34.04)
      effect: read
      questions:
      - Can I export resources affected by one CVE to a file on the current v34.04 API?
      - Is there a 34.04 download of CVE impacted resources filtered by resource type?
      instructions:
      - text: Download the v34.04 impacted-resources file for {cve}.
        slots:
          cve: query.cve
      - text: Export 34.04 {resourceType} resources impacted by {cve}.
        slots:
          cve: query.cve
          resourceType: query.resourceType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/stats/vulnerabilities/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Recalculate vulnerability stats (v34.04)
      effect: write
      questions:
      - How do I make CVE statistics recalculate on the current v34.04 API?
      - Can I trigger a vulnerability stats refresh with version 34.04?
      instructions:
      - text: Refresh the vulnerability stats via the v34.04 API.
      - text: Recompute CVE stats using stats version 34.04.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Check my API key's usage and quota
      effect: read
      questions:
      - How many API requests has my key made against its quota?
      - Which endpoints is my API key calling the most?
      - Am I close to my Palo Alto Networks subscription request limit?
      instructions:
      - text: Show my API key usage statistics and quota limits.
      - text: Break down my API request consumption by endpoint.
      method: generated
      generated: '2026-09-26'