# 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 Tas Droplets API
  version: 1.0.0
extends: openapi/palo-alto-networks-tas-droplets-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: 12
- target: $.paths['/api/v34.03/tas-droplets'].get
  update:
    x-apievangelist-phrasing:
      intent: List scanned TAS droplets (v34.03)
      effect: read
      questions:
      - Using the v34.03 API, which Tanzu Application Service droplets have been scanned?
      - Can I filter v34.03 TAS droplet results by severity or compliance rule?
      instructions:
      - text: List TAS droplets from the v34.03 API with severity {normalizedSeverity}.
        slots:
          normalizedSeverity: query.normalizedSeverity
      - text: Show v34.03 TAS droplets for cloud controller {cloudControllerAddresses}.
        slots:
          cloudControllerAddresses: query.cloudControllerAddresses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/tas-droplets/addresses'].get
  update:
    x-apievangelist-phrasing:
      intent: List TAS cloud controller addresses (v34.03)
      effect: read
      questions:
      - What TAS cloud controller addresses does the v34.03 API know about?
      - Can I get the list of cloud controllers from the v34.03 droplet endpoint?
      instructions:
      - text: List the TAS cloud controller addresses via v34.03.
      - text: Show v34.03 cloud controller addresses for runtime {runtime}.
        slots:
          runtime: query.runtime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/tas-droplets/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download TAS droplet scan results (v34.03)
      effect: read
      questions:
      - How do I export TAS droplet scan results with the v34.03 API?
      - Can the v34.03 droplet download be limited to undefended droplets?
      instructions:
      - text: Download the v34.03 TAS droplet report.
      - text: Download v34.03 TAS droplets filtered to defended status {defended}.
        slots:
          defended: query.defended
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/tas-droplets/progress'].get
  update:
    x-apievangelist-phrasing:
      intent: View TAS droplet scan progress (v34.03)
      effect: read
      questions:
      - How far along is the TAS droplet scan according to the v34.03 API?
      - Is a v34.03 droplet scan still running?
      instructions:
      - text: Check TAS droplet scan progress on v34.03.
      - text: Show me the v34.03 droplet scan status.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/tas-droplets/scan'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a TAS droplet scan (v34.03)
      effect: write
      questions:
      - How do I kick off a TAS droplet scan with the v34.03 API?
      - Can I trigger a fresh droplet scan through v34.03?
      instructions:
      - text: Start a TAS droplet scan using v34.03.
      - text: Trigger the v34.03 droplet scanner now.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/tas-droplets/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an ongoing TAS droplet scan (v34.03)
      effect: destructive
      questions:
      - Can I cancel a TAS droplet scan in progress with the v34.03 API?
      - What stops a running v34.03 droplet scan?
      instructions:
      - text: Stop the ongoing TAS droplet scan via v34.03.
      - text: Cancel the running v34.03 droplet scan.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/tas-droplets'].get
  update:
    x-apievangelist-phrasing:
      intent: List scanned TAS droplets (v34.04)
      effect: read
      questions:
      - Which Tanzu droplets have vulnerabilities in the current v34.04 API?
      - Can I sort v34.04 TAS droplet results or filter them by issue type?
      instructions:
      - text: List TAS droplets from v34.04 with issue type {issueType}.
        slots:
          issueType: query.issueType
      - text: Show {limit} v34.04 TAS droplets sorted by {sort}.
        slots:
          limit: query.limit
          sort: query.sort
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/tas-droplets/addresses'].get
  update:
    x-apievangelist-phrasing:
      intent: List TAS cloud controller addresses (v34.04)
      effect: read
      questions:
      - Which cloud controller addresses does the v34.04 TAS droplet API return?
      - Where do I get the cloud controllers to filter v34.04 droplets by?
      instructions:
      - text: List the TAS cloud controller addresses via v34.04.
      - text: Show v34.04 cloud controller addresses on platform {platform}.
        slots:
          platform: query.platform
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/tas-droplets/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download TAS droplet scan results (v34.04)
      effect: read
      questions:
      - How do I download TAS droplet findings from the v34.04 API?
      - Can I export only droplets failing a specific compliance ID in v34.04?
      instructions:
      - text: Download the v34.04 TAS droplet report.
      - text: Download v34.04 droplets that match compliance IDs {complianceIDs}.
        slots:
          complianceIDs: query.complianceIDs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/tas-droplets/progress'].get
  update:
    x-apievangelist-phrasing:
      intent: View TAS droplet scan progress (v34.04)
      effect: read
      questions:
      - What's the progress of the TAS droplet scan in the v34.04 API?
      - Has the v34.04 droplet scan finished yet?
      instructions:
      - text: Check TAS droplet scan progress on v34.04.
      - text: Show me the v34.04 droplet scan status.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/tas-droplets/scan'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a TAS droplet scan (v34.04)
      effect: write
      questions:
      - How do I start scanning my TAS droplets with the v34.04 API?
      - Can I rescan droplets on demand through v34.04?
      instructions:
      - text: Start a TAS droplet scan using v34.04.
      - text: Trigger the v34.04 droplet scanner now.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/tas-droplets/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an ongoing TAS droplet scan (v34.04)
      effect: destructive
      questions:
      - Can I halt a running TAS droplet scan in v34.04?
      - What call cancels the current v34.04 droplet scan?
      instructions:
      - text: Stop the ongoing TAS droplet scan via v34.04.
      - text: Cancel the running v34.04 droplet scan.
      method: generated
      generated: '2026-09-26'