# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ZTNA Connector Restful Subnet API
  version: 1.0.0
extends: openapi/palo-alto-networks-subnet-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: 6
- target: $.paths['/sse/connector/v2.0/api/subnets'].get
  update:
    x-apievangelist-phrasing:
      intent: List connector subnets
      effect: read
      questions:
      - Which subnets are defined in my ZTNA connector setup?
      - Can I search or filter the connector subnet list?
      instructions:
      - text: List connector subnets matching {search}.
        slots:
          search: query.search
      - text: Show connector subnets in region {x-panw-region} sorted by {sort}.
        slots:
          x-panw-region: header.x-panw-region
          sort: query.sort
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/connector/v2.0/api/subnets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a connector subnet
      effect: write
      questions:
      - How do I add a subnet to a connector group?
      - Can I allow ICMP when I define a new connector subnet?
      instructions:
      - text: Create connector subnet {name} in group {group} covering {ip_subnets}.
        slots:
          name: requestBody.name
          group: requestBody.group
          ip_subnets: requestBody.ip_subnets
      - text: Add subnet {name} to connector group {group} with ICMP allowed set to {icmp_allowed}.
        slots:
          name: requestBody.name
          group: requestBody.group
          icmp_allowed: requestBody.icmp_allowed
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/connector/v2.0/api/subnets/{oid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a connector subnet
      effect: read
      questions:
      - What IP ranges and group does a specific connector subnet have?
      - Can I look up one connector subnet by its object ID?
      instructions:
      - text: Show connector subnet {oid}.
        slots:
          oid: path.oid
      - text: Get the details of subnet object {oid}.
        slots:
          oid: path.oid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/connector/v2.0/api/subnets/{oid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a connector subnet
      effect: write
      questions:
      - Can I change the IP ranges on an existing connector subnet?
      - Is it possible to move a connector subnet to another group?
      instructions:
      - text: Update connector subnet {oid} to cover {ip_subnets}.
        slots:
          oid: path.oid
          ip_subnets: requestBody.ip_subnets
      - text: Move subnet {oid} into connector group {group}.
        slots:
          oid: path.oid
          group: requestBody.group
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/connector/v2.0/api/subnets/{oid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a connector subnet
      effect: destructive
      questions:
      - How do I remove a subnet from my connector configuration?
      - Does deleting a connector subnet cut off access to that IP range?
      instructions:
      - text: Delete connector subnet {oid}.
        slots:
          oid: path.oid
      - text: Remove subnet object {oid} from the connector setup.
        slots:
          oid: path.oid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/connector/v2.0/api/subnets/filters'].get
  update:
    x-apievangelist-phrasing:
      intent: Get filter values for subnet fields
      effect: read
      questions:
      - What values can I filter connector subnets on for a given field?
      - Which distinct groups appear across my connector subnets?
      instructions:
      - text: Get the available filter values for subnet field {field}.
        slots:
          field: query.field
      - text: Look up subnet filter options for {field} matching {search}.
        slots:
          field: query.field
          search: query.search
      method: generated
      generated: '2026-09-26'