# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for pcs-command-center Command Center API
  version: 1.0.0
extends: openapi/palo-alto-networks-command-center-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['/commandcenter/api/v1/summary/{swimlane-type}'].post
  update:
    x-apievangelist-phrasing:
      intent: Count alerts by severity for a swimlane
      effect: read
      questions:
      - How many critical, high and medium alerts do I have in the command center?
      - What is the longest time range I can request alert counts for?
      instructions:
      - text: Count {swimlane} alerts by severity over {range}.
        slots:
          swimlane: path.swimlane-type
          range: requestBody.timeRange
      - text: Summarize {swimlane} alert severities over {range} for filters {filters}.
        slots:
          swimlane: path.swimlane-type
          range: requestBody.timeRange
          filters: requestBody.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/commandcenter/api/v1/top-assets/{swimlane-type}'].post
  update:
    x-apievangelist-phrasing:
      intent: List assets with the most alerts
      effect: read
      questions:
      - Which cloud assets have the highest number of alerts?
      - Can I get the top 10 assets for misconfigurations over the last week?
      instructions:
      - text: List the top {limit} assets by {swimlane} alerts over {range}.
        slots:
          limit: requestBody.limit
          swimlane: path.swimlane-type
          range: requestBody.timeRange
      - text: Show which assets carry the most {swimlane} alerts in {range}.
        slots:
          swimlane: path.swimlane-type
          range: requestBody.timeRange
      method: generated
      generated: '2026-09-26'
- target: $.paths['/commandcenter/api/v1/top-policies/{swimlane-type}'].post
  update:
    x-apievangelist-phrasing:
      intent: List policies generating the most alerts
      effect: read
      questions:
      - Which policies are triggering the most alerts?
      - Can I rank policies by alert volume for incidents only?
      instructions:
      - text: List the top {limit} policies by {swimlane} alerts over {range}.
        slots:
          limit: requestBody.limit
          swimlane: path.swimlane-type
          range: requestBody.timeRange
      - text: Show the noisiest {swimlane} policies in {range}.
        slots:
          swimlane: path.swimlane-type
          range: requestBody.timeRange
      method: generated
      generated: '2026-09-26'
- target: $.paths['/commandcenter/v1/top-vulnerabilities'].post
  update:
    x-apievangelist-phrasing:
      intent: List hosts and images with most vulnerabilities
      effect: read
      questions:
      - Which hosts and container images have the most vulnerabilities?
      - Can I see the top five vulnerable images for my account groups?
      instructions:
      - text: Show the top vulnerable {type} over {range}.
        slots:
          type: query.type
          range: requestBody.timeRange
      - text: List the {limit} hosts and images with the most vulnerabilities.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/commandcenter/v1/vulnerabilities/summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize vulnerable images and hosts
      effect: read
      questions:
      - How many of my images and hosts are vulnerable in total?
      - What does the overall vulnerability summary look like for a time range?
      instructions:
      - text: Summarize total vulnerable images and hosts over {range}.
        slots:
          range: requestBody.timeRange
      - text: Count vulnerable hosts and images for Prisma ID {prisma_id}.
        slots:
          prisma_id: query.prismaId
      method: generated
      generated: '2026-09-26'