# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Overview IoT Public API
  version: 1.0.0
extends: openapi/palo-alto-networks-iot-public-api-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: 56
- target: $.paths['/iot/pub/v1/device'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an IoT device by MAC address
      effect: read
      questions:
      - What does IoT Security know about the device with a given MAC address?
      - Can I look up a static-IP device's details the same way I look up a MAC address?
      instructions:
      - text: Show me the IoT device details for this MAC address.
      - text: Pull the device record for the static IP device I'm asking about by its MAC-or-IP lookup.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/device/ip'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an IoT device by IP address
      effect: read
      questions:
      - Which device is sitting at a particular IP address in my IoT inventory?
      - Can I get IoT device details if I only know the IP address, not the MAC?
      instructions:
      - text: Get the IoT device details for this IP address.
      - text: Identify the device behind this IP using the per-IP device lookup.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/device/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List the full IoT device inventory
      effect: read
      questions:
      - How do I export every device in my IoT Security inventory?
      - What's the rate limit when pulling the whole device inventory list?
      instructions:
      - text: List all devices in my IoT Security inventory using the original v1 inventory.
      - text: Dump the complete IoT device inventory.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v2/device/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List the device inventory with chosen attributes
      effect: read
      questions:
      - Can I choose which device attributes come back when I pull the IoT inventory?
      - Is there a newer inventory endpoint for Strata Cloud Manager customers?
      instructions:
      - text: List my IoT devices with the v2 inventory, returning only the attributes I pick.
      - text: Pull the SCM device inventory v2 with a trimmed attribute set.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v2/device/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search for a device or multi-interface device
      effect: read
      questions:
      - How can I find a multi-interface device by one of its IP or MAC addresses?
      - Is there a device search that works for SCM customers but not the standalone portal?
      instructions:
      - text: Search for the device or multi-interface device matching this IP or MAC.
      - text: Run a v2 device search to find every interface of this device.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/profile/mapping'].get
  update:
    x-apievangelist-phrasing:
      intent: Map device profiles to categories and verticals
      effect: read
      questions:
      - Which category and industry vertical does each IoT device profile belong to?
      - Can I get the mapping for all possible device profiles, not just the ones on my network?
      instructions:
      - text: Get the full device profile to category and vertical mapping.
      - text: Show which industry vertical each IoT device profile maps to.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/tag/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List user-defined device tags
      effect: read
      questions:
      - What user-defined tags have been assigned to my IoT devices?
      - Where can I see all the manual tags people created for devices?
      instructions:
      - text: List the user-defined tags on my IoT devices.
      - text: Show me every manual device tag in use.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/tag'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a manual tag to devices
      effect: write
      questions:
      - How do I tag a group of IoT devices manually?
      - Can I apply one manual tag to several devices at once?
      instructions:
      - text: Add a manual tag to these IoT devices.
      - text: Tag the devices I listed with a new manual tag.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/tag'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a manual tag from devices
      effect: destructive
      questions:
      - How do I take a manual tag off some IoT devices?
      - Can I strip a user-defined tag from several devices in one call?
      instructions:
      - text: Remove the manual tag from these devices.
      - text: Untag the listed IoT devices.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/alert/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List IoT security alerts
      effect: read
      questions:
      - What security alerts has IoT Security raised on my devices?
      - How often can I poll the security alert list?
      instructions:
      - text: List my IoT security alerts.
      - text: Pull the current security alerts from IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/alert/update'].put
  update:
    x-apievangelist-phrasing:
      intent: Resolve an IoT security alert
      effect: write
      questions:
      - How do I mark an IoT security alert as resolved?
      - Can I close out a security alert through the API?
      instructions:
      - text: Resolve this IoT security alert.
      - text: Mark the alert I just reviewed as resolved.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/vulnerability/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List vulnerability instances
      effect: read
      questions:
      - Which vulnerabilities have been found on my IoT devices?
      - Can I pull every vulnerability instance IoT Security is tracking?
      instructions:
      - text: List the vulnerability instances on my IoT devices.
      - text: Show open device vulnerabilities from IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/vulnerability/update'].put
  update:
    x-apievangelist-phrasing:
      intent: Resolve vulnerability instances
      effect: write
      questions:
      - How do I mark a device vulnerability as fixed?
      - Can I resolve several instances of a vulnerability at once?
      instructions:
      - text: Mark these vulnerability instances as resolved.
      - text: Resolve the vulnerability on the devices we patched.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/device/bulkUpdate'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update devices from Cisco DNAC or Prime
      effect: write
      questions:
      - Can I enrich IoT devices with data from Cisco DNA Center?
      - How do I push Cisco Prime device info into IoT Security in bulk?
      instructions:
      - text: Bulk update my IoT devices with the Cisco DNA Center data from XSOAR.
      - text: Push Cisco Prime device information into the IoT inventory.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/device/bulkUpdate?updateSource=cisco_wlc'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update devices from Cisco WLAN controllers
      effect: write
      questions:
      - Can device details from Cisco wireless LAN controllers update my IoT inventory?
      - What's the bulk update source for Cisco WLC data?
      instructions:
      - text: Bulk update devices with data pulled from our Cisco WLAN controllers.
      - text: Sync Cisco WLC client info into IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/device/bulkUpdate?updateSource=aruba_wlc'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update devices from Aruba WLAN controllers
      effect: write
      questions:
      - Can I feed Aruba wireless controller data into IoT Security?
      - Which bulk update handles devices seen by Aruba WLCs?
      instructions:
      - text: Bulk update IoT devices with information from our Aruba WLAN controllers.
      - text: Sync Aruba WLC device data into the inventory.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/device/bulkUpdate?updateSource=snmp'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update devices from SNMP switch data
      effect: write
      questions:
      - Can switch data collected over SNMP update my IoT devices?
      - Which bulk update source uses SNMP from integrated switches?
      instructions:
      - text: Bulk update devices with the switch data XSOAR gathered over SNMP.
      - text: Push SNMP-sourced switch port info into IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/device/bulkUpdate?updateSource=cellular'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update cellular devices
      effect: write
      questions:
      - Is there a bulk update just for cellular IoT devices?
      - Can I refresh cellular device records in one request?
      instructions:
      - text: Run a bulk update for our cellular devices.
      - text: Update the cellular device records in IoT Security in bulk.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/device/bulkUpdate?updateSource=sccm'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update devices from SCCM
      effect: write
      questions:
      - Can I sync SCCM-managed devices into IoT Security?
      - Which bulk update source covers SCCM device data?
      instructions:
      - text: Bulk update IoT devices with our SCCM device data.
      - text: Push SCCM endpoint info into the device inventory.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/device/bulkUpdate?updateSource=crowdstrike_falcon'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update devices from CrowdStrike Falcon
      effect: write
      questions:
      - Can CrowdStrike Falcon device data enrich my IoT inventory?
      - Which bulk update source is for Falcon-managed devices?
      instructions:
      - text: Bulk update devices with data from CrowdStrike Falcon.
      - text: Sync Falcon device details into IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/network/subnetBulkUpdate?updateSource=ipam_infoblox'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update subnets from Infoblox IPAM
      effect: write
      questions:
      - Can I import subnets from our Infoblox IPAM into IoT Security?
      - Is there a bulk subnet update for IPAM data?
      instructions:
      - text: Bulk update IoT Security subnets from our Infoblox IPAM.
      - text: Sync IPAM subnet definitions into IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/device/bulkUpdate?updateSource=customAttribute'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk set custom attribute values on devices
      effect: write
      questions:
      - How do I set custom attribute values on many devices at once?
      - Can I bulk-fill a custom attribute across my device inventory?
      instructions:
      - text: Bulk update custom attribute values on these devices.
      - text: Set our custom attribute value across the listed devices.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/policy/recommendation'].get
  update:
    x-apievangelist-phrasing:
      intent: Get activated policy rule recommendations
      effect: read
      questions:
      - Which firewall policy rule recommendations are activated for my IoT devices?
      - Can I get recommendations for just one or two device profiles?
      instructions:
      - text: Fetch all activated policy rule recommendations.
      - text: Get the activated recommendations for the device profiles I care about.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/alertVuln/capability'].get
  update:
    x-apievangelist-phrasing:
      intent: List alert and vulnerability capabilities
      effect: read
      questions:
      - What alert and vulnerability capabilities does my IoT Security tenant have right now?
      - Which IoT capabilities apply to alerts versus vulnerabilities?
      instructions:
      - text: List the current IoT alert and vulnerability capabilities.
      - text: Show which alert and vulnerability features are enabled.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/network/ndNodeGraphBulkUpdate'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update network discovery node graphs
      effect: write
      questions:
      - How do network discovery results update the device node graph?
      - Can I push node graph data for discovered devices in bulk?
      instructions:
      - text: Bulk update the node graph for our network discovery devices.
      - text: Push the discovered device node graph into IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/network/ndNodeL2L3BulkUpdate'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update network discovery L2/L3 data
      effect: write
      questions:
      - Can I upload layer 2 and layer 3 data for discovered devices?
      - Which bulk update carries L2L3 info from network discovery?
      instructions:
      - text: Bulk update L2/L3 details for network discovery devices.
      - text: Push discovered layer 2 and layer 3 device data.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/network/ndNodeEndpointBulkUpdate'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update network discovery endpoints
      effect: write
      questions:
      - How do I send endpoint data for devices found by network discovery?
      - Can discovered endpoints be updated in bulk?
      instructions:
      - text: Bulk update endpoint data for network discovery devices.
      - text: Push discovered endpoints into IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/xsoar/integrations'].get
  update:
    x-apievangelist-phrasing:
      intent: List active XSOAR integrations
      effect: read
      questions:
      - Which XSOAR integrations are active and succeeding for IoT Security?
      - Is there a cap on integrations with a basic third-party license?
      instructions:
      - text: List my active XSOAR integrations.
      - text: Show which third-party integrations are currently running successfully.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/xsoar/device/reportUpload'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a device vulnerability scan report
      effect: write
      questions:
      - How does XSOAR send a device vulnerability scan report back to IoT Security?
      - Can scan reports from XSOAR be uploaded to IoT?
      instructions:
      - text: Upload this device vulnerability scan report from XSOAR.
      - text: Report the XSOAR scan results back to IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/xsoar/profile/aclSync/status'].post
  update:
    x-apievangelist-phrasing:
      intent: Report profile ACL sync job status
      effect: write
      questions:
      - How does IoT Security learn whether a profile ACL sync job finished?
      - Can XSOAR report ACL sync status back to IoT?
      instructions:
      - text: Send the profile ACL sync job status from XSOAR.
      - text: Report that the ACL sync for these profiles completed.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/xsoar/device/scanDetails'].post
  update:
    x-apievangelist-phrasing:
      intent: Report third-party scanner details
      effect: write
      questions:
      - Can XSOAR pass along details about third-party scanners to IoT Security?
      - Where do I submit 3rd party scanner info collected by XSOAR?
      instructions:
      - text: Submit the third-party scanner details XSOAR collected.
      - text: Send our external scanner details to IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/network/securityRules'].put
  update:
    x-apievangelist-phrasing:
      intent: Update firewall security rules
      effect: write
      questions:
      - Can I update a list of firewall security rules from IoT Security?
      - How do I push changed firewall rules through the IoT API?
      instructions:
      - text: Update these firewall security rules.
      - text: Push the revised security rule list to the firewall.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/network/purgeRules'].delete
  update:
    x-apievangelist-phrasing:
      intent: Purge firewall rules not in a kept list
      effect: destructive
      questions:
      - How do I remove invalid firewall rules while keeping the ones I list?
      - Can I purge every rule except a retained set?
      instructions:
      - text: Keep only the rules I'm sending and purge every other firewall rule.
      - text: Remove invalid firewall security rules outside this retained list.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/thirdPartyScan'].put
  update:
    x-apievangelist-phrasing:
      intent: Merge third-party CVE findings into devices
      effect: write
      questions:
      - Can CVEs from a third-party scanner be joined with IoT device CVE records?
      - How do I update device CVEs from an external integration?
      instructions:
      - text: Update device CVEs with these third-party scan results.
      - text: Merge the external scanner's CVE findings into our IoT device records.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/xsoar/status'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync XSOAR playbook status to IoT
      effect: write
      questions:
      - How does IoT Security get the status of an XSOAR integration playbook?
      - Can I sync playbook run status back into IoT?
      instructions:
      - text: Sync the XSOAR integration playbook status to IoT Security.
      - text: Report our playbook run status to IoT.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/xsoar/heartbeat'].get
  update:
    x-apievangelist-phrasing:
      intent: Send an XSOAR instance heartbeat
      effect: read
      questions:
      - How does IoT Security know my XSOAR instance is healthy?
      - What heartbeat should an XSOAR instance send to IoT?
      instructions:
      - text: Send a heartbeat from our XSOAR instance to IoT Security.
      - text: Ping IoT with the XSOAR health heartbeat.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/filters'].get
  update:
    x-apievangelist-phrasing:
      intent: List saved filters
      effect: read
      questions:
      - What saved filters exist in my IoT Security tenant?
      - Can I retrieve the filters our team saved?
      instructions:
      - text: List my saved IoT filters.
      - text: Show the saved filters in IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/customAttributes'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom device attributes
      effect: read
      questions:
      - Which custom attributes have we defined for IoT devices?
      - Can I see all our custom attribute definitions?
      instructions:
      - text: List the custom attributes defined in IoT Security.
      - text: Show all our custom device attribute definitions.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/customAttribute'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a custom attribute definition
      effect: write
      questions:
      - How do I change an existing custom attribute?
      - Can I edit a custom attribute definition after creating it?
      instructions:
      - text: Update the definition of this existing custom attribute.
      - text: Edit our custom attribute's settings.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/customAttribute'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom attribute
      effect: write
      questions:
      - How do I add a new custom attribute for devices?
      - Can I define my own device attribute in IoT Security?
      instructions:
      - text: Create a new custom device attribute.
      - text: Define a custom attribute we can set on devices.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/customAttribute'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom attribute
      effect: destructive
      questions:
      - How do I remove a custom attribute we no longer use?
      - Can a custom attribute definition be deleted?
      instructions:
      - text: Delete this custom attribute.
      - text: Remove the unused custom attribute definition.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/site'].get
  update:
    x-apievangelist-phrasing:
      intent: Get site definitions
      effect: read
      questions:
      - What sites are defined in IoT Security?
      - Can I retrieve my site definitions?
      instructions:
      - text: Get the site definitions from IoT Security.
      - text: List our IoT sites.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/site'].put
  update:
    x-apievangelist-phrasing:
      intent: Update site definitions
      effect: write
      questions:
      - How do I change an existing site definition?
      - Can I update several sites at once?
      instructions:
      - text: Update these existing site definitions.
      - text: Edit the sites I listed in IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/site'].post
  update:
    x-apievangelist-phrasing:
      intent: Create site definitions
      effect: write
      questions:
      - How do I add new sites to IoT Security?
      - Can I create more than one site definition in a request?
      instructions:
      - text: Create these new site definitions.
      - text: Add our new locations as IoT sites.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/site'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete site definitions
      effect: destructive
      questions:
      - How do I remove sites from IoT Security?
      - Can several site definitions be deleted together?
      instructions:
      - text: Delete these site definitions.
      - text: Remove the retired sites from IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/networkSegment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get network segment definitions
      effect: read
      questions:
      - What network segments are defined in IoT Security?
      - Can I list my network segment definitions?
      instructions:
      - text: Get our network segment definitions.
      - text: List the network segments configured in IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/networkSegment'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a network segment definition
      effect: write
      questions:
      - How do I change an existing network segment?
      - Can I edit a network segment definition?
      instructions:
      - text: Update this network segment definition.
      - text: Edit the existing network segment's settings.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/networkSegment'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a network segment definition
      effect: write
      questions:
      - How do I add a new network segment?
      - Can I define a network segment in IoT Security?
      instructions:
      - text: Create a new network segment definition.
      - text: Add a network segment for this part of the network.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/networkSegment'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a network segment definition
      effect: destructive
      questions:
      - How do I remove a network segment?
      - Can a network segment definition be deleted?
      instructions:
      - text: Delete this network segment definition.
      - text: Remove the obsolete network segment.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/subnet'].get
  update:
    x-apievangelist-phrasing:
      intent: Get subnet definitions
      effect: read
      questions:
      - What subnets are defined in IoT Security?
      - Can I retrieve my subnet definitions?
      instructions:
      - text: Get the subnet definitions from IoT Security.
      - text: List our defined subnets.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/subnet'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a subnet definition
      effect: write
      questions:
      - How do I change an existing subnet definition?
      - Can a subnet's settings be edited?
      instructions:
      - text: Update this subnet definition.
      - text: Edit the existing subnet in IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/subnet'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a subnet definition
      effect: write
      questions:
      - How do I add a new subnet to IoT Security?
      - Can I define a subnet through the API?
      instructions:
      - text: Create a new subnet definition.
      - text: Add this subnet to IoT Security.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/subnet'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a subnet definition
      effect: destructive
      questions:
      - How do I remove a subnet definition?
      - Can I delete a subnet from IoT Security?
      instructions:
      - text: Delete this subnet definition.
      - text: Remove the unused subnet.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/subnet/transfer'].put
  update:
    x-apievangelist-phrasing:
      intent: Transfer a subnet to a shared IP block
      effect: write
      questions:
      - How do I move a subnet into a shared IP block?
      - Can a subnet be shared across sites as an IP block?
      instructions:
      - text: Transfer this subnet to a shared IP block.
      - text: Make the subnet part of a shared IP block.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v1/subnet/revert'].put
  update:
    x-apievangelist-phrasing:
      intent: Revert a shared block to unshared
      effect: write
      questions:
      - How do I undo sharing an IP block?
      - Can a shared block go back to being an unshared IP block?
      instructions:
      - text: Revert this shared block to an unshared IP block.
      - text: Unshare the IP block I transferred earlier.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iot/pub/v2/device/attributes'].get
  update:
    x-apievangelist-phrasing:
      intent: List available device attributes
      effect: read
      questions:
      - Which device attributes, including third-party integration ones, can I query?
      - What attribute names can I request in the v2 inventory?
      instructions:
      - text: List all device attributes, native and from enabled integrations.
      - text: Show the attribute names available for IoT devices.
      method: generated
      generated: '2026-09-26'