# 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 Devices API
  version: 1.0.0
extends: openapi/palo-alto-networks-devices-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: 14
- target: $.paths['/seb-api/v1/devices'].get
  update:
    x-apievangelist-phrasing:
      intent: List browser-protected endpoint devices
      effect: read
      questions:
      - Which devices running the secure enterprise browser have disk encryption turned off?
      - Can I filter enterprise browser devices by hostname, user or OS type?
      - What devices have not been seen since a certain date?
      instructions:
      - text: List secure browser devices used by {user}.
        slots:
          user: query.user.name
      - text: Find secure browser devices with firewall status {status}.
        slots:
          status: query.device.firewall_status
      - text: Show secure browser devices last seen before {date}, sorted by {sort}.
        slots:
          date: query.device.last_seen_lte
          sort: query.sort
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/devices/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one secure browser device
      effect: read
      questions:
      - How do I pull the full record for one secure browser device?
      - What security posture details are stored for a single enterprise browser device?
      instructions:
      - text: Get secure browser device {id}.
        slots:
          id: path.id
      - text: Show the posture details of enterprise browser device {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/devices/archive'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive browser devices
      effect: write
      questions:
      - How do I archive devices that are no longer in use?
      - Can I archive several enterprise browser devices at once?
      instructions:
      - text: Archive devices {device_ids}.
        slots:
          device_ids: requestBody.deviceIds
      - text: Move browser devices {device_ids} to archived status.
        slots:
          device_ids: requestBody.deviceIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/devices/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore archived browser devices
      effect: write
      questions:
      - How do I bring an archived device back to active?
      - Can I un-archive multiple devices in one request?
      instructions:
      - text: Restore archived devices {device_ids}.
        slots:
          device_ids: requestBody.deviceIds
      - text: Reactivate the archived browser devices {device_ids}.
        slots:
          device_ids: requestBody.deviceIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/devices/suspend'].post
  update:
    x-apievangelist-phrasing:
      intent: Suspend browser devices
      effect: write
      questions:
      - How do I temporarily block a lost laptop from the enterprise browser?
      - Can I suspend a batch of devices at once?
      instructions:
      - text: Suspend devices {device_ids}.
        slots:
          device_ids: requestBody.deviceIds
      - text: Put browser devices {device_ids} into suspended status.
        slots:
          device_ids: requestBody.deviceIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/devices/resume'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume suspended browser devices
      effect: write
      questions:
      - How do I lift a suspension on a device?
      - Do I need to resume a suspended device before I can delete it?
      instructions:
      - text: Resume suspended devices {device_ids}.
        slots:
          device_ids: requestBody.deviceIds
      - text: Unsuspend browser devices {device_ids} and set them active.
        slots:
          device_ids: requestBody.deviceIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/devices/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete browser devices
      effect: destructive
      questions:
      - How do I permanently remove devices from the enterprise browser inventory?
      - Why can't I delete a device that is currently suspended?
      instructions:
      - text: Permanently delete devices {device_ids}.
        slots:
          device_ids: requestBody.deviceIds
      - text: Delete browser devices {device_ids} for good.
        slots:
          device_ids: requestBody.deviceIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/devices/force-reauth'].post
  update:
    x-apievangelist-phrasing:
      intent: Force users to re-authenticate on devices
      effect: write
      questions:
      - How do I make a user sign in again to the browser on a specific device?
      - Can I force re-authentication on several devices after a credential leak?
      instructions:
      - text: Force re-authentication on devices {device_ids}.
        slots:
          device_ids: requestBody.deviceIds
      - text: Require users on devices {device_ids} to sign in to the browser again.
        slots:
          device_ids: requestBody.deviceIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/device/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List discovered IoT and OT devices
      effect: read
      questions:
      - What IoT and OT devices has IoT Security discovered on my network?
      - Can I list only unmonitored IoT devices active in a time window?
      instructions:
      - text: List discovered IoT devices for tenant {customer}.
        slots:
          customer: query.customerid
      - text: Show IoT devices for tenant {customer} active between {start} and {end}.
        slots:
          customer: query.customerid
          start: query.stime
          end: query.etime
      - text: List {monitored} IoT devices for tenant {customer}, {page_size} per page.
        slots:
          monitored: query.filter_monitored
          customer: query.customerid
          page_size: query.pagelength
      method: generated
      generated: '2026-09-26'
- target: $.paths['/device/detail'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an IoT device's risk and profile details
      effect: read
      questions:
      - What is the risk score breakdown for a specific IoT device?
      - Can I see network activity and classification for one discovered device?
      instructions:
      - text: Get IoT device {device} details for tenant {customer}.
        slots:
          device: query.deviceid
          customer: query.customerid
      - text: Show the risk score breakdown of IoT device {device}.
        slots:
          device: query.deviceid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/devices'].get
  update:
    x-apievangelist-phrasing:
      intent: List Prisma Access Browser managed devices
      effect: read
      questions:
      - Which managed devices running Prisma Access Browser are out of compliance?
      - Can I see browser versions on managed devices for one OS platform?
      instructions:
      - text: List Prisma Access Browser managed devices with compliance status {status}.
        slots:
          status: query.compliance_status
      - text: Show Prisma Access Browser managed devices on {platform}.
        slots:
          platform: query.platform
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devices'].get
  update:
    x-apievangelist-phrasing:
      intent: List Strata Cloud Manager devices
      effect: read
      questions:
      - Which firewalls are onboarded as devices in Strata Cloud Manager?
      - Can I look up a Strata Cloud Manager device by name?
      instructions:
      - text: List my Strata Cloud Manager devices.
      - text: Find the Strata Cloud Manager device named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devices/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Strata Cloud Manager device
      effect: read
      questions:
      - How do I fetch one Strata Cloud Manager device by its UUID?
      - What folder, labels and snippets is a configuration device assigned to?
      instructions:
      - text: Get Strata Cloud Manager device {id}.
        slots:
          id: path.id
      - text: Show the folder and snippets of configuration device {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devices/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Strata Cloud Manager device
      effect: write
      questions:
      - How do I move a device into a different folder in Strata Cloud Manager?
      - Can I rename a configuration device or change its labels?
      instructions:
      - text: Move device {id} into folder {folder}.
        slots:
          id: path.id
          folder: requestBody.folder
      - text: Rename device {id} to {display_name}.
        slots:
          id: path.id
          display_name: requestBody.display_name
      - text: Set labels {labels} on configuration device {id}.
        slots:
          labels: requestBody.labels
          id: path.id
      method: generated
      generated: '2026-09-26'