Palo Alto Networks · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Prisma Cloud Access Keys API Overview Data Security…

8 actions 8 updates phrasing extends openapi/palo-alto-networks-data-security-dashboard-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Palo Alto Networks's API. It is a proposal applied on top of the contract, not a document Palo Alto Networks publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 8

$.info
$.paths['/dlp/api/v1/dashboard/alerts/aggregate'].post
$.paths['/dlp/api/v1/dashboard/objects/aggregate/by-classification'].post
$.paths['/dlp/api/v1/dashboard/objects/aggregate/by-owner'].post
$.paths['/dlp/api/v1/dashboard/objects/aggregate/by-region'].post
$.paths['/dlp/api/v1/dashboard/objects/aggregate/sensitive-exposed'].post
$.paths['/dlp/api/v1/dashboard/resources/aggregate/by-exposure'].post
$.paths['/dlp/api/v1/dashboard/violations/aggregate'].post

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Cloud Access Keys API Overview Data Security…
  version: 1.0.0
extends: openapi/palo-alto-networks-data-security-dashboard-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: 7
- target: $.paths['/dlp/api/v1/dashboard/alerts/aggregate'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize total, public, sensitive and malware objects
      effect: read
      questions:
      - How many of my cloud storage objects are public, sensitive, or malware?
      - What headline object counts does the data security dashboard show?
      instructions:
      - text: Get dashboard totals of public, sensitive and malware objects for accounts {accountIds} over {timeRange}.
        slots:
          accountIds: requestBody.accountIds
          timeRange: requestBody.timeRange
      - text: Show the malware and sensitive object summary for account groups {accountGroupIds}.
        slots:
          accountGroupIds: requestBody.accountGroupIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dlp/api/v1/dashboard/objects/aggregate/by-classification'].post
  update:
    x-apievangelist-phrasing:
      intent: Top public object counts by classification
      effect: read
      questions:
      - Which data classifications have the most publicly exposed objects?
      - Can I limit how many classifications the public-object breakdown returns?
      instructions:
      - text: Show the top {limit} classifications by public object count for accounts {accountIds}.
        slots:
          limit: requestBody.limit
          accountIds: requestBody.accountIds
      - text: Break down public objects by classification for {classifications} over {timeRange}.
        slots:
          classifications: requestBody.classifications
          timeRange: requestBody.timeRange
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dlp/api/v1/dashboard/objects/aggregate/by-owner'].post
  update:
    x-apievangelist-phrasing:
      intent: Object exposure counts per owner
      effect: read
      questions:
      - Which owners have the most exposed objects in my cloud storage?
      - What does object exposure look like per owner?
      instructions:
      - text: Show object exposure counts per owner for accounts {accountIds}.
        slots:
          accountIds: requestBody.accountIds
      - text: List the top {limit} owners by exposed objects over {timeRange}.
        slots:
          limit: requestBody.limit
          timeRange: requestBody.timeRange
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dlp/api/v1/dashboard/objects/aggregate/by-region'].post
  update:
    x-apievangelist-phrasing:
      intent: Object counts by region and classification
      effect: read
      questions:
      - Which cloud regions hold the most classified objects?
      - Can I see object counts by region split by classification?
      instructions:
      - text: Show object counts by region for account group {accountGroupNames}.
        slots:
          accountGroupNames: requestBody.accountGroupNames
      - text: Break down objects per region by classification for accounts {accountIds}.
        slots:
          accountIds: requestBody.accountIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dlp/api/v1/dashboard/objects/aggregate/sensitive-exposed'].post
  update:
    x-apievangelist-phrasing:
      intent: Count sensitive objects by exposure
      effect: read
      questions:
      - How many sensitive objects are exposed publicly versus kept private?
      - What's the count of sensitive-and-exposed objects on the dashboard?
      instructions:
      - text: Count sensitive objects by exposure for accounts {accountIds} over {timeRange}.
        slots:
          accountIds: requestBody.accountIds
          timeRange: requestBody.timeRange
      - text: Show sensitive exposed object counts for classifications {classifications}.
        slots:
          classifications: requestBody.classifications
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dlp/api/v1/dashboard/resources/aggregate/by-exposure'].post
  update:
    x-apievangelist-phrasing:
      intent: Count resources and objects by exposure
      effect: read
      questions:
      - How many storage resources do I have, and how exposed are their objects?
      - What's the total resource count on the data security dashboard?
      instructions:
      - text: Get total resources and object exposure counts for accounts {accountIds}.
        slots:
          accountIds: requestBody.accountIds
      - text: Show resource exposure totals for account groups {accountGroupIds} over {timeRange}.
        slots:
          accountGroupIds: requestBody.accountGroupIds
          timeRange: requestBody.timeRange
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dlp/api/v1/dashboard/violations/aggregate'].post
  update:
    x-apievangelist-phrasing:
      intent: List data security dashboard violations
      effect: read
      questions:
      - What data security policy violations show on my dashboard?
      - Can I see violations for just one account group in a time window?
      instructions:
      - text: List dashboard violations for accounts {accountIds} over {timeRange}.
        slots:
          accountIds: requestBody.accountIds
          timeRange: requestBody.timeRange
      - text: Show the top {limit} data security violations for account group {accountGroupNames}.
        slots:
          limit: requestBody.limit
          accountGroupNames: requestBody.accountGroupNames
      method: generated
      generated: '2026-09-26'