# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Advanced DNS Security Resolver Configuration Connection…
  version: 1.0.0
extends: openapi/palo-alto-networks-connection-source-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: 12
- target: $.paths['/adns-resolver/v1/connection-sources'].get
  update:
    x-apievangelist-phrasing:
      intent: List DNS resolver connection sources
      effect: read
      questions:
      - Which connection sources are set up for my DNS resolver?
      - Can I search connection sources by name, description or profile name?
      - How do I sort connection sources by when they were created?
      instructions:
      - text: List my connection sources.
      - text: Search connection sources for {search}.
        slots:
          search: query.search
      - text: List connection sources sorted by {sort_by} in {sort_order} order.
        slots:
          sort_by: query.sort_by
          sort_order: query.sort_order
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a connection source
      effect: write
      questions:
      - How do I add a new connection source tied to a resolver profile?
      - What do I need to create a connection source besides a name?
      instructions:
      - text: Create connection source {name} linked to profile {profile_id}.
        slots:
          name: requestBody.name
          profile_id: requestBody.profile_id
      - text: Add connection source {name} for profile {profile_id} with description {description}.
        slots:
          name: requestBody.name
          profile_id: requestBody.profile_id
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources/subnets'].get
  update:
    x-apievangelist-phrasing:
      intent: List all tenant subnets
      effect: read
      questions:
      - What subnets are registered across my whole tenant, regardless of connection source?
      - Can I find tenant subnets by CIDR and sort them by verification status?
      instructions:
      - text: List every tenant subnet.
      - text: Find tenant subnets matching CIDR {search}.
        slots:
          search: query.search
      - text: List tenant-wide subnets sorted by {sort_by}.
        slots:
          sort_by: query.sort_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources/subnets/{subnet-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tenant subnet
      effect: read
      questions:
      - How do I look up one tenant subnet by its ID without knowing its connection source?
      - Is a particular tenant subnet verified?
      instructions:
      - text: Get tenant subnet {subnet_id}.
        slots:
          subnet_id: path.subnet-id
      - text: Check the CIDR and verification state of tenant subnet {subnet_id}.
        slots:
          subnet_id: path.subnet-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources/{connection-source-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a connection source
      effect: read
      questions:
      - Which profile is a specific connection source associated with?
      - Can I retrieve a single connection source by its ID?
      instructions:
      - text: Get connection source {connection_source_id}.
        slots:
          connection_source_id: path.connection-source-id
      - text: Show the name, description and profile of connection source {connection_source_id}.
        slots:
          connection_source_id: path.connection-source-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources/{connection-source-id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a connection source
      effect: write
      questions:
      - How do I point an existing connection source at a different profile?
      - Can I rename a connection source after creating it?
      instructions:
      - text: Move connection source {connection_source_id} ({name}) to profile {profile_id}.
        slots:
          connection_source_id: path.connection-source-id
          name: requestBody.name
          profile_id: requestBody.profile_id
      - text: Rename connection source {connection_source_id} to {name}, keeping profile {profile_id}.
        slots:
          connection_source_id: path.connection-source-id
          name: requestBody.name
          profile_id: requestBody.profile_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources/{connection-source-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a connection source
      effect: destructive
      questions:
      - How do I remove a connection source I no longer need?
      - Can a connection source be deleted by ID?
      instructions:
      - text: Delete connection source {connection_source_id}.
        slots:
          connection_source_id: path.connection-source-id
      - text: Remove the connection source with ID {connection_source_id}.
        slots:
          connection_source_id: path.connection-source-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources/{connection-source-id}/subnets'].get
  update:
    x-apievangelist-phrasing:
      intent: List a connection source's subnets
      effect: read
      questions:
      - Which subnets belong to one particular connection source?
      - Can I filter a connection source's subnets by CIDR?
      instructions:
      - text: List the subnets of connection source {connection_source_id}.
        slots:
          connection_source_id: path.connection-source-id
      - text: Search connection source {connection_source_id} subnets for CIDR {search}.
        slots:
          connection_source_id: path.connection-source-id
          search: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources/{connection-source-id}/subnets'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a subnet to a connection source
      effect: write
      questions:
      - How do I add a CIDR block to a connection source?
      - What format does a new connection source subnet need?
      instructions:
      - text: Add subnet {cidr} to connection source {connection_source_id}.
        slots:
          cidr: requestBody.cidr
          connection_source_id: path.connection-source-id
      - text: Register CIDR {cidr} under connection source {connection_source_id}.
        slots:
          cidr: requestBody.cidr
          connection_source_id: path.connection-source-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources/{connection-source-id}/subnets/{subnet-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a connection source subnet
      effect: read
      questions:
      - How can I view one subnet that sits under a specific connection source?
      - Has a subnet on my connection source been verified yet?
      instructions:
      - text: Get subnet {subnet_id} of connection source {connection_source_id}.
        slots:
          subnet_id: path.subnet-id
          connection_source_id: path.connection-source-id
      - text: Show verification status for subnet {subnet_id} on connection source {connection_source_id}.
        slots:
          subnet_id: path.subnet-id
          connection_source_id: path.connection-source-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources/{connection-source-id}/subnets/{subnet-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a subnet from a connection source
      effect: destructive
      questions:
      - How do I take a subnet off a connection source?
      - Can I delete a single CIDR from a connection source without deleting the source?
      instructions:
      - text: Delete subnet {subnet_id} from connection source {connection_source_id}.
        slots:
          subnet_id: path.subnet-id
          connection_source_id: path.connection-source-id
      - text: Remove CIDR entry {subnet_id} under connection source {connection_source_id}.
        slots:
          subnet_id: path.subnet-id
          connection_source_id: path.connection-source-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adns-resolver/v1/connection-sources/{connection-source-id}/subnets/{subnet-id}:verify-update'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify ownership of a connection source subnet
      effect: write
      questions:
      - How do I prove I own a subnet using the token from the verification URL?
      - What's needed to mark a connection source subnet as verified?
      instructions:
      - text: Verify subnet {subnet_id} on connection source {connection_source_id} with CIDR {cidr}, token {token} and URL {verification_url}.
        slots:
          subnet_id: path.subnet-id
          connection_source_id: path.connection-source-id
          cidr: requestBody.cidr
          token: requestBody.token
          verification_url: requestBody.verification_url
      - text: Submit verification token {token} from {verification_url} for {cidr} (subnet {subnet_id}, source {connection_source_id}).
        slots:
          token: requestBody.token
          verification_url: requestBody.verification_url
          cidr: requestBody.cidr
          subnet_id: path.subnet-id
          connection_source_id: path.connection-source-id
      method: generated
      generated: '2026-09-26'