# 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 Agentless API
  version: 1.0.0
extends: openapi/palo-alto-networks-agentless-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/agentless/max-scanners'].post
  update:
    x-apievangelist-phrasing:
      intent: Set max agentless scanners for an account (v34.03)
      effect: write
      questions:
      - How do I cap the number of agentless scanners for a cloud account on the v34.03 API?
      - Can I turn on auto-scaling of agentless scanners with the older v34.03 endpoint?
      instructions:
      - text: Via v34.03, set max agentless scanners for account {account_id} to {max_scanners}.
        slots:
          account_id: requestBody.account_id
          max_scanners: requestBody.max_scanners
      - text: Using v34.03, set agentless auto-scale to {auto_scale} for account {account_id}.
        slots:
          auto_scale: requestBody.auto_scale
          account_id: requestBody.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/agentless/progress'].get
  update:
    x-apievangelist-phrasing:
      intent: View agentless scan progress (v34.03)
      effect: read
      questions:
      - How far along is the current agentless scan according to the v34.03 API?
      - Where do I check agentless scan progress on v34.03?
      instructions:
      - text: Show agentless scan progress from the v34.03 API.
      - text: Check v34.03 agentless scanning progress.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/agentless/scan'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an agentless scan (v34.03)
      effect: write
      questions:
      - How do I kick off an agentless scan with the v34.03 API?
      - Can an agentless scan be started on demand using v34.03?
      instructions:
      - text: Start an agentless scan using the v34.03 API.
      - text: Launch a v34.03 agentless scan now.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/agentless/scan-statistics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get agentless scan statistics (v34.03)
      effect: read
      questions:
      - What statistics does the v34.03 API report for agentless scans?
      - Can I restrict v34.03 agentless scan statistics to the current scan?
      instructions:
      - text: Get agentless scan statistics from v34.03.
      - text: Show v34.03 agentless statistics with current set to {current}.
        slots:
          current: query.current
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/agentless/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an ongoing agentless scan (v34.03)
      effect: destructive
      questions:
      - How do I halt a running agentless scan through the v34.03 API?
      - Is there a v34.03 call to cancel agentless scanning in progress?
      instructions:
      - text: Stop the ongoing agentless scan via v34.03.
      - text: Cancel the running v34.03 agentless scan.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/agentless/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Download agentless permission templates (v34.03)
      effect: read
      questions:
      - Where do I get the cloud permission templates agentless scanning needs, on v34.03?
      - Can the v34.03 template download target a specific AWS region type?
      instructions:
      - text: Download v34.03 agentless permission templates for credential {credentialID}.
        slots:
          credentialID: requestBody.credentialID
      - text: Get v34.03 agentless templates for AWS region type {awsRegionType}.
        slots:
          awsRegionType: requestBody.awsRegionType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/agentless/max-scanners'].post
  update:
    x-apievangelist-phrasing:
      intent: Set max agentless scanners for an account (v34.04)
      effect: write
      questions:
      - How do I limit how many agentless scanners run for an account on the current v34.04 API?
      - Can v34.04 auto-scale agentless scanners for a cloud account?
      instructions:
      - text: Set the v34.04 max agentless scanners for account {account_id} to {max_scanners}.
        slots:
          account_id: requestBody.account_id
          max_scanners: requestBody.max_scanners
      - text: Enable v34.04 agentless auto-scale {auto_scale} on account {account_id}.
        slots:
          auto_scale: requestBody.auto_scale
          account_id: requestBody.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/agentless/progress'].get
  update:
    x-apievangelist-phrasing:
      intent: View agentless scan progress (v34.04)
      effect: read
      questions:
      - Is my agentless scan still running according to the v34.04 API?
      - What progress does the v34.04 agentless endpoint show right now?
      instructions:
      - text: Show v34.04 agentless scan progress.
      - text: Report how far the agentless scan has gotten using v34.04.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/agentless/scan'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an agentless scan (v34.04)
      effect: write
      questions:
      - How do I start agentless scanning with the current v34.04 API?
      - Can I trigger an agentless scan immediately on v34.04?
      instructions:
      - text: Start an agentless scan with v34.04.
      - text: Trigger a v34.04 agentless scan of my accounts.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/agentless/scan-statistics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get agentless scan statistics (v34.04)
      effect: read
      questions:
      - Which agentless scan statistics does v34.04 return?
      - Can I pull only the current agentless scan's numbers from v34.04?
      instructions:
      - text: Get v34.04 agentless scan statistics.
      - text: Show v34.04 agentless scan statistics for current {current}.
        slots:
          current: query.current
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/agentless/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an ongoing agentless scan (v34.04)
      effect: destructive
      questions:
      - How do I stop an agentless scan that is in progress on v34.04?
      - Can a running agentless scan be aborted with the v34.04 API?
      instructions:
      - text: Stop the ongoing agentless scan via v34.04.
      - text: Abort the running v34.04 agentless scan.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/agentless/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Download agentless permission templates (v34.04)
      effect: read
      questions:
      - Where do I download the permission templates for agentless scanning on v34.04?
      - Can v34.04 generate agentless templates from a stored credential?
      instructions:
      - text: Download v34.04 agentless permission templates for credential {credentialID}.
        slots:
          credentialID: requestBody.credentialID
      - text: Fetch v34.04 agentless templates for AWS region type {awsRegionType}.
        slots:
          awsRegionType: requestBody.awsRegionType
      method: generated
      generated: '2026-09-26'