Palo Alto Networks · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Palo Alto Networks Images API

17 actions 17 updates phrasing extends openapi/palo-alto-networks-images-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 17 · first 16 shown; the file carries all of them

$.info
$.paths['/api/v34.03/images'].get
$.paths['/api/v34.03/images/download'].get
$.paths['/api/v34.03/images/evaluate'].post
$.paths['/api/v34.03/images/names'].get
$.paths['/api/v34.03/images/scan'].post
$.paths['/api/v34.03/images/twistlock_defender_app_embedded.tar.gz'].get
$.paths['/api/v34.03/images/twistlock_defender_layer.zip'].post
$.paths['/api/v34.04/images'].get
$.paths['/api/v34.04/images/download'].get
$.paths['/api/v34.04/images/evaluate'].post
$.paths['/api/v34.04/images/names'].get
$.paths['/api/v34.04/images/scan'].post
$.paths['/api/v34.04/images/twistlock_defender_app_embedded.tar.gz'].get
$.paths['/api/v34.04/images/twistlock_defender_layer.zip'].post
$.paths['/images'].get

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 Palo Alto Networks Images API
  version: 1.0.0
extends: openapi/palo-alto-networks-images-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: 16
- target: $.paths['/api/v34.03/images'].get
  update:
    x-apievangelist-phrasing:
      intent: Get image scan results (v34.03)
      effect: read
      questions:
      - Where do I see container image scan results with the v34.03 API?
      - Can I filter v34.03 image results by cluster and compliance rule?
      instructions:
      - text: On v34.03, show image scan results for host {hostname}.
        slots:
          hostname: query.hostname
      - text: Fetch v34.03 image findings in cluster {clusters}.
        slots:
          clusters: query.clusters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/images/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download image scan results (v34.03)
      effect: read
      questions:
      - Can I export deployed image scan results with the older v34.03 endpoint?
      - Is a file download of v34.03 image findings filterable by registry?
      instructions:
      - text: Download the v34.03 image scan report for registry {registry}.
        slots:
          registry: query.registry
      - text: Export every image scan result to a file through version 34.03.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/images/evaluate'].post
  update:
    x-apievangelist-phrasing:
      intent: Resolve images (v34.03)
      effect: read
      questions:
      - Can I resolve a batch of images to their scan data using v34.03?
      - Which v34.03 call evaluates a list of images I send it?
      instructions:
      - text: Resolve images {images} with the v34.03 evaluate endpoint.
        slots:
          images: requestBody.images
      - text: Evaluate this set of images through API version 34.03.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/images/names'].get
  update:
    x-apievangelist-phrasing:
      intent: List image names (v34.03)
      effect: read
      questions:
      - What container image names has Defender seen, according to v34.03?
      - Can I retrieve only deployed image names on version 34.03?
      instructions:
      - text: List deployed image names in repository {repository} via v34.03.
        slots:
          repository: query.repository
      - text: Return just image names from the older v34.03 images API.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/images/scan'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an image scan (v34.03)
      effect: write
      questions:
      - Can I rescan deployed images on a host with the v34.03 API?
      - Is it possible to scan one image tag on demand in version 34.03?
      instructions:
      - text: Start a v34.03 image scan on host {hostname}.
        slots:
          hostname: requestBody.hostname
      - text: Rescan image tag {imageTag} using API v34.03.
        slots:
          imageTag: requestBody.imageTag
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/images/twistlock_defender_app_embedded.tar.gz'].get
  update:
    x-apievangelist-phrasing:
      intent: Download App-Embedded Defender (v34.03)
      effect: read
      questions:
      - Where can I get the App-Embedded Defender archive from the v34.03 API?
      - Can I fetch the App-Embedded Defender tarball on version 34.03?
      instructions:
      - text: Download the App-Embedded Defender tar.gz via v34.03.
      - text: Grab the v34.03 App-Embedded Defender package for my container image.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/images/twistlock_defender_layer.zip'].post
  update:
    x-apievangelist-phrasing:
      intent: Download serverless Defender layer (v34.03)
      effect: read
      questions:
      - Can I download the serverless Defender layer bundle for a runtime on v34.03?
      - Which v34.03 call gives me the Defender Lambda layer zip?
      instructions:
      - text: Download the v34.03 serverless Defender layer for runtime {runtime}.
        slots:
          runtime: requestBody.runtime
      - text: Get the Defender layer zip for provider {provider} using API v34.03.
        slots:
          provider: requestBody.provider
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/images'].get
  update:
    x-apievangelist-phrasing:
      intent: Get image scan results
      effect: read
      questions:
      - What vulnerabilities and compliance issues are in my deployed container images?
      - Can I see image scan results only for agentless scans or one cluster?
      instructions:
      - text: Show image scan results for image {name}.
        slots:
          name: query.name
      - text: List image findings with severity {normalizedSeverity} on API v34.04.
        slots:
          normalizedSeverity: query.normalizedSeverity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/images/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download image scan results
      effect: read
      questions:
      - How do I download deployed image scan results as a file?
      - Can the image results download be limited to one cluster on v34.04?
      instructions:
      - text: Download image scan results for cluster {clusters}.
        slots:
          clusters: query.clusters
      - text: Export the latest v34.04 deployed-image scan report.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/images/evaluate'].post
  update:
    x-apievangelist-phrasing:
      intent: Resolve images
      effect: read
      questions:
      - Can I send a list of images and get them resolved against scan data?
      - What does the image evaluate call return for the images I pass in?
      instructions:
      - text: Resolve the images {images}.
        slots:
          images: requestBody.images
      - text: Evaluate a batch of images I provide with the current v34.04 endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/images/names'].get
  update:
    x-apievangelist-phrasing:
      intent: List image names
      effect: read
      questions:
      - Which container image names are known from deployed workloads?
      - Can I get a lightweight list of image names filtered by host?
      instructions:
      - text: List image names running on host {hostname}.
        slots:
          hostname: query.hostname
      - text: Give me the deployed image names only, v34.04 API.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/images/scan'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an image scan
      effect: write
      questions:
      - How can I force a rescan of the images running on a host?
      - Can I trigger a scan of just one image tag?
      instructions:
      - text: Scan images on host {hostname} now.
        slots:
          hostname: requestBody.hostname
      - text: Start an on-demand scan of image tag {imageTag} on v34.04.
        slots:
          imageTag: requestBody.imageTag
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/images/twistlock_defender_app_embedded.tar.gz'].get
  update:
    x-apievangelist-phrasing:
      intent: Download App-Embedded Defender
      effect: read
      questions:
      - Where do I download the App-Embedded Defender to embed in my container?
      - Is the App-Embedded Defender archive available from the current images API?
      instructions:
      - text: Download the App-Embedded Defender archive.
      - text: Fetch the latest App-Embedded Defender tar.gz on API version 34.04.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/images/twistlock_defender_layer.zip'].post
  update:
    x-apievangelist-phrasing:
      intent: Download serverless Defender layer
      effect: read
      questions:
      - How do I get the Defender layer to protect my serverless functions?
      - Can I choose the runtime and Node.js module type for the serverless layer bundle?
      instructions:
      - text: Download the serverless Defender layer bundle for runtime {runtime}.
        slots:
          runtime: requestBody.runtime
      - text: Build a Defender layer zip with module type {nodeJSModuleType} on v34.04.
        slots:
          nodeJSModuleType: requestBody.nodeJSModuleType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/images'].get
  update:
    x-apievangelist-phrasing:
      intent: List image vulnerability results
      effect: read
      questions:
      - Which of my container images have vulnerabilities or compliance problems?
      - Can I search image scan results by a keyword or collection?
      instructions:
      - text: List image scan results matching {search}.
        slots:
          search: query.search
      - text: Show vulnerability results for images in collection {collections}.
        slots:
          collections: query.collections
      method: generated
      generated: '2026-09-26'
- target: $.paths['/images/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Export image scan results as CSV
      effect: read
      questions:
      - Can I export image scan results to CSV for my vulnerability tracker?
      - Is there a CSV export of image findings I can filter by collection?
      instructions:
      - text: Export image scan results to CSV for collection {collections}.
        slots:
          collections: query.collections
      - text: Download a CSV of image findings matching {search}.
        slots:
          search: query.search
      method: generated
      generated: '2026-09-26'