API Evangelist conversational phrasing for Tenable Platform & Settings Networks API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Tenable Platform & Settings Networks API
  version: 1.0.0
extends: openapi/tenable-networks-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/networks'].get
  update:
    x-apievangelist-phrasing:
      intent: List network objects
      effect: read
      questions:
      - What network objects are set up in my Tenable organization?
      - Can I include deleted networks when listing them?
      instructions:
      - text: List all my network objects.
      - text: 'List networks including deleted ones: {includeDeleted}.'
        slots:
          includeDeleted: query.includeDeleted
      method: generated
      generated: '2026-10-01'
- target: $.paths['/networks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a network object
      effect: write
      questions:
      - How do I create a network to separate overlapping IP ranges?
      - Can I set how many days assets live in a new network before they age out?
      - Can AWS assets be placed into a network object?
      instructions:
      - text: Create a network named {name}.
        slots:
          name: requestBody.name
      - text: Create network {name} with an asset age-out of {assets_ttl_days} days.
        slots:
          name: requestBody.name
          assets_ttl_days: requestBody.assets_ttl_days
      method: generated
      generated: '2026-10-01'
- target: $.paths['/networks/{network_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a network
      effect: read
      questions:
      - What settings does a specific network object have?
      - Can I look up one network by its ID?
      instructions:
      - text: Get the details of network {network_id}.
        slots:
          network_id: path.network_id
      - text: Show me the name and asset TTL of network {network_id}.
        slots:
          network_id: path.network_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/networks/{network_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a network's name or settings
      effect: write
      questions:
      - Can I rename an existing network object?
      - Do I need to resend the name when I only change a network's description?
      instructions:
      - text: Rename network {network_id} to {name}.
        slots:
          network_id: path.network_id
          name: requestBody.name
      - text: Update network {network_id} named {name} to age out assets after {assets_ttl_days} days.
        slots:
          network_id: path.network_id
          name: requestBody.name
          assets_ttl_days: requestBody.assets_ttl_days
      method: generated
      generated: '2026-10-01'
- target: $.paths['/networks/{network_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a network object
      effect: destructive
      questions:
      - What should I do with assets before deleting a network?
      - Can I delete a custom network I no longer need?
      instructions:
      - text: Delete network {network_id}.
        slots:
          network_id: path.network_id
      - text: Remove the custom network object {network_id}.
        slots:
          network_id: path.network_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/networks/{network_id}/counts/assets-not-seen-in/{num_days}'].get
  update:
    x-apievangelist-phrasing:
      intent: Count stale assets in a network
      effect: read
      questions:
      - How many assets in a network haven't been seen in the last 30 days?
      - What's the total asset count for a given network?
      instructions:
      - text: Count assets in network {network_id} not seen in {num_days} days.
        slots:
          network_id: path.network_id
          num_days: path.num_days
      - text: Give me the total and stale asset counts for network {network_id} over {num_days} days.
        slots:
          network_id: path.network_id
          num_days: path.num_days
      method: generated
      generated: '2026-10-01'
- target: $.paths['/networks/{network_id}/scanners/{scanner_uuid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign one scanner to a network
      effect: write
      questions:
      - How do I put a single scanner or scanner group into a custom network?
      - Can I return a scanner to the default network?
      instructions:
      - text: Assign scanner {scanner_uuid} to network {network_id}.
        slots:
          scanner_uuid: path.scanner_uuid
          network_id: path.network_id
      - text: Move scanner group {scanner_uuid} into network {network_id}.
        slots:
          scanner_uuid: path.scanner_uuid
          network_id: path.network_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/networks/{network_id}/scanners'].get
  update:
    x-apievangelist-phrasing:
      intent: List scanners in a network
      effect: read
      questions:
      - Which scanners and scanner groups belong to a given network?
      - What sensors are currently assigned to my custom network?
      instructions:
      - text: List scanners assigned to network {network_id}.
        slots:
          network_id: path.network_id
      - text: Show me the scanner groups in network {network_id}.
        slots:
          network_id: path.network_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/networks/{network_id}/scanners'].post
  update:
    x-apievangelist-phrasing:
      intent: Replace a network's scanner assignments
      effect: write
      questions:
      - Can I set the full list of scanners for a network in one call?
      - Does bulk assigning scanners overwrite the ones already in the network?
      instructions:
      - text: Set the scanners for network {network_id} to {scanner_uuids}.
        slots:
          network_id: path.network_id
          scanner_uuids: requestBody.scanner_uuids
      - text: Bulk assign scanners {scanner_uuids} to network {network_id}, replacing the current list.
        slots:
          scanner_uuids: requestBody.scanner_uuids
          network_id: path.network_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/networks/{network_id}/assignable-scanners'].get
  update:
    x-apievangelist-phrasing:
      intent: List scanners available to add to a network
      effect: read
      questions:
      - Which scanners aren't assigned to any custom network yet?
      - What scanners could I still add to this network?
      instructions:
      - text: List scanners I can assign to network {network_id}.
        slots:
          network_id: path.network_id
      - text: Show unassigned scanners and groups available for network {network_id}.
        slots:
          network_id: path.network_id
      method: generated
      generated: '2026-10-01'