# 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 NAT Rules API
  version: 1.0.0
extends: openapi/palo-alto-networks-nat-rules-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: 7
- target: $.paths['/nat-rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List NAT rules
      effect: read
      questions:
      - Which NAT rules are in the pre-rulebase of a folder?
      - Can I find a NAT rule by its name?
      instructions:
      - text: List {position} NAT rules in folder {folder}.
        slots:
          position: query.position
          folder: query.folder
      - text: Find the {position} NAT rule named {name}.
        slots:
          position: query.position
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nat-rules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a NAT rule
      effect: write
      questions:
      - How do I create a NAT rule that translates source addresses?
      - Can I bind a new NAT rule to a specific egress interface?
      instructions:
      - text: Create {position} NAT rule {name} (id {id}) from zone {from} to zone {to} for source {source}, destination {destination}, service {service}.
        slots:
          position: query.position
          name: requestBody.name
          id: requestBody.id
          from: requestBody.from
          to: requestBody.to
          source: requestBody.source
          destination: requestBody.destination
          service: requestBody.service
      - text: 'Add NAT rule {name} (id {id}) at {position}: {from}->{to}, {source} to {destination} on {service}.'
        slots:
          name: requestBody.name
          id: requestBody.id
          position: query.position
          from: requestBody.from
          to: requestBody.to
          source: requestBody.source
          destination: requestBody.destination
          service: requestBody.service
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nat-rules/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a NAT rule
      effect: read
      questions:
      - What translation does one NAT rule perform?
      - Can I retrieve a NAT rule by its id?
      instructions:
      - text: Show NAT rule {id}.
        slots:
          id: path.id
      - text: Get the definition of NAT rule {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nat-rules/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a NAT rule
      effect: write
      questions:
      - How do I disable an existing NAT rule without deleting it?
      - Can I change the source translation on a NAT rule I already created?
      instructions:
      - text: 'Update existing {position} NAT rule {id} named {name}: zones {from} to {to}, source {source}, destination {destination}, service {service}.'
        slots:
          position: query.position
          id: path.id
          name: requestBody.name
          from: requestBody.from
          to: requestBody.to
          source: requestBody.source
          destination: requestBody.destination
          service: requestBody.service
      - text: Set disabled={disabled} on existing NAT rule {id}.
        slots:
          disabled: requestBody.disabled
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nat-rules/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a NAT rule
      effect: destructive
      questions:
      - How do I delete a NAT rule?
      - Can I remove an old address translation rule by id?
      instructions:
      - text: Delete NAT rule {id}.
        slots:
          id: path.id
      - text: Remove the address translation rule {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/config/v1/nat-rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List Prisma Access NAT rules
      effect: read
      questions:
      - Which NAT rules are configured in a Prisma Access folder or snippet?
      - Can I page through Prisma Access NAT rules by position?
      instructions:
      - text: List Prisma Access NAT rules in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the Prisma Access NAT rule named {name} in snippet {snippet}.
        slots:
          name: query.name
          snippet: query.snippet
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/nat-rules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Prisma Access NAT rule
      effect: write
      questions:
      - How do I add a NAT rule to a Prisma Access folder?
      - Can I set destination translation on a new Prisma Access NAT rule?
      instructions:
      - text: Create Prisma Access NAT rule {name} in folder {folder}.
        slots:
          name: requestBody.name
          folder: query.folder
      - text: Add Prisma Access NAT rule {name} to snippet {snippet} with destination translation {destination_translation}.
        slots:
          name: requestBody.name
          snippet: query.snippet
          destination_translation: requestBody.destination_translation
      method: generated
      generated: '2026-10-01'