# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Network Services Layer 3 Subinterfaces API
  version: 1.0.0
extends: openapi/palo-alto-networks-layer-3-subinterfaces-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: 5
- target: $.paths['/layer3-subinterfaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List layer 3 subinterfaces
      effect: read
      questions:
      - Which layer 3 subinterfaces are configured on a device?
      - Can I list layer 3 subinterfaces in a specific folder or snippet?
      instructions:
      - text: List layer 3 subinterfaces on device {device}.
        slots:
          device: query.device
      - text: Show layer 3 subinterfaces in folder {folder}.
        slots:
          folder: query.folder
      method: generated
      generated: '2026-09-26'
- target: $.paths['/layer3-subinterfaces'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a layer 3 subinterface
      effect: write
      questions:
      - How do I add a VLAN-tagged layer 3 subinterface to a parent interface?
      - Can I set MTU and a management profile when creating a subinterface?
      instructions:
      - text: Create layer 3 subinterface {name} on {parent_interface} with tag {tag}.
        slots:
          name: requestBody.name
          parent_interface: requestBody.parent_interface
          tag: requestBody.tag
      - text: Add subinterface {name} with MTU {mtu} and management profile {interface_management_profile}.
        slots:
          name: requestBody.name
          mtu: requestBody.mtu
          interface_management_profile: requestBody.interface_management_profile
      method: generated
      generated: '2026-09-26'
- target: $.paths['/layer3-subinterfaces/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a layer 3 subinterface
      effect: read
      questions:
      - What tag, MTU and parent interface does a particular subinterface have?
      - How do I fetch one layer 3 subinterface by ID?
      instructions:
      - text: Get layer 3 subinterface {id}.
        slots:
          id: path.id
      - text: Show the settings of subinterface {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/layer3-subinterfaces/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a layer 3 subinterface
      effect: write
      questions:
      - Can I change the MTU on an existing layer 3 subinterface?
      - How do I attach a NetFlow profile to a subinterface that already exists?
      instructions:
      - text: Set the MTU of layer 3 subinterface {id} ({name}) to {mtu}.
        slots:
          id: path.id
          name: requestBody.name
          mtu: requestBody.mtu
      - text: Apply NetFlow profile {netflow_profile} to subinterface {id} named {name}.
        slots:
          netflow_profile: requestBody.netflow_profile
          id: path.id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/layer3-subinterfaces/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a layer 3 subinterface
      effect: destructive
      questions:
      - How do I remove a layer 3 subinterface?
      - Is deleting a subinterface reversible?
      instructions:
      - text: Delete layer 3 subinterface {id}.
        slots:
          id: path.id
      - text: Remove the subinterface with ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'