# 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 Wildcard API
  version: 1.0.0
extends: openapi/palo-alto-networks-wildcard-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/wildcards'].get
  update:
    x-apievangelist-phrasing:
      intent: List ZTNA connector wildcards
      effect: read
      questions:
      - Which wildcard FQDN apps are configured on my connectors?
      - Can I search and sort the list of wildcards?
      instructions:
      - text: List wildcards matching {search}.
        slots:
          search: query.search
      - text: Show {limit} wildcards sorted by {sort}.
        slots:
          limit: query.limit
          sort: query.sort
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/connector/v2.0/api/wildcards'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a connector wildcard
      effect: write
      questions:
      - How do I publish a wildcard domain like *.example.com through a connector group?
      - Can I set TCP ports and ICMP when creating a wildcard?
      instructions:
      - text: Create wildcard {name} for FQDN {fqdn} in connector group {group}.
        slots:
          name: requestBody.name
          fqdn: requestBody.fqdn
          group: requestBody.group
      - text: Add wildcard {name} for {fqdn} on group {group} with TCP ports {tcp_port}.
        slots:
          name: requestBody.name
          fqdn: requestBody.fqdn
          group: requestBody.group
          tcp_port: requestBody.tcp_port
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/connector/v2.0/api/wildcards/{oid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a connector wildcard
      effect: read
      questions:
      - How do I see the configuration of one wildcard?
      - What ports and probe settings does a given wildcard use?
      instructions:
      - text: Get wildcard {oid}.
        slots:
          oid: path.oid
      - text: Show the settings of wildcard {oid}.
        slots:
          oid: path.oid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/connector/v2.0/api/wildcards/{oid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a connector wildcard
      effect: write
      questions:
      - Can I change the FQDN or ports on an existing wildcard?
      - How do I move a wildcard to a different connector group?
      instructions:
      - text: Update wildcard {oid} (id {id}) to name {name}, FQDN {fqdn}, group {group}.
        slots:
          oid: path.oid
          id: requestBody.id
          name: requestBody.name
          fqdn: requestBody.fqdn
          group: requestBody.group
      - text: Move wildcard {oid} (id {id}, {name}, {fqdn}) into connector group {group}.
        slots:
          oid: path.oid
          id: requestBody.id
          name: requestBody.name
          fqdn: requestBody.fqdn
          group: requestBody.group
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/connector/v2.0/api/wildcards/{oid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a connector wildcard
      effect: destructive
      questions:
      - How do I delete a wildcard from my connectors?
      - Can I stop publishing a wildcard domain by removing it?
      instructions:
      - text: Delete wildcard {oid}.
        slots:
          oid: path.oid
      - text: Remove wildcard {oid} permanently.
        slots:
          oid: path.oid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/connector/v2.0/api/wildcards/filters'].get
  update:
    x-apievangelist-phrasing:
      intent: List filter values for wildcard fields
      effect: read
      questions:
      - What filter values can I use for a wildcard field?
      - Which distinct values exist for a field across my wildcards?
      instructions:
      - text: List filter values for wildcard field {field}.
        slots:
          field: query.field
      - text: Find wildcard filter values for {field} matching {search}.
        slots:
          field: query.field
          search: query.search
      method: generated
      generated: '2026-09-26'