# 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 Cortex XDR REST Scripts API
  version: 1.0.0
extends: openapi/palo-alto-networks-scripts-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: 2
- target: $.paths['/scripts/run_script'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a library script on endpoints
      effect: write
      questions:
      - Can I run a remediation script on several endpoints at once?
      - How do I collect forensic data from an endpoint with a script from the library?
      instructions:
      - text: Run the library script described in {request_data} on the target endpoints.
        slots:
          request_data: requestBody.request_data
      - text: Execute a script on endpoints with request {request_data} and return the action ID.
        slots:
          request_data: requestBody.request_data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scripts/get_script_execution_results'].post
  update:
    x-apievangelist-phrasing:
      intent: Get results of a script run
      effect: read
      questions:
      - What output did my script produce on each endpoint?
      - Can I fetch script results using the action ID from the run?
      instructions:
      - text: Get the script execution results for request {request_data}.
        slots:
          request_data: requestBody.request_data
      - text: Show output of the script run identified in {request_data}.
        slots:
          request_data: requestBody.request_data
      method: generated
      generated: '2026-09-26'