# 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 SD-WAN Traffic Distribution Profiles API
  version: 1.0.0
extends: openapi/palo-alto-networks-sd-wan-traffic-distribution-profiles-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['/sdwan-traffic-distribution-profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List SD-WAN traffic distribution profiles
      effect: read
      questions:
      - Which SD-WAN traffic distribution profiles are configured?
      - Can I list distribution profiles for one folder or device?
      instructions:
      - text: List SD-WAN traffic distribution profiles in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the traffic distribution profile named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sdwan-traffic-distribution-profiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an SD-WAN traffic distribution profile
      effect: write
      questions:
      - How do I define how SD-WAN traffic is spread across links?
      - Can I pick links by tag when creating a distribution profile?
      instructions:
      - text: Create SD-WAN traffic distribution profile {name} using {traffic_distribution}.
        slots:
          name: requestBody.name
          traffic_distribution: requestBody.traffic_distribution
      - text: Add distribution profile {name} over links tagged {link_tags}.
        slots:
          name: requestBody.name
          link_tags: requestBody.link_tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sdwan-traffic-distribution-profiles/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an SD-WAN traffic distribution profile
      effect: read
      questions:
      - What distribution method and link tags does a specific profile use?
      - Can I fetch one SD-WAN distribution profile by UUID?
      instructions:
      - text: Get SD-WAN traffic distribution profile {id}.
        slots:
          id: path.id
      - text: Show the link tags on distribution profile {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sdwan-traffic-distribution-profiles/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an SD-WAN traffic distribution profile
      effect: write
      questions:
      - How do I switch an existing profile to a different distribution method?
      - Can I change which link tags an SD-WAN profile uses?
      instructions:
      - text: Update existing distribution profile {id} ({name}) to use {traffic_distribution}.
        slots:
          id: path.id
          name: requestBody.name
          traffic_distribution: requestBody.traffic_distribution
      - text: Set link tags {link_tags} on SD-WAN profile {id}.
        slots:
          link_tags: requestBody.link_tags
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sdwan-traffic-distribution-profiles/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an SD-WAN traffic distribution profile
      effect: destructive
      questions:
      - How do I remove an SD-WAN traffic distribution profile?
      - Can a distribution profile be deleted by UUID?
      instructions:
      - text: Delete SD-WAN traffic distribution profile {id}.
        slots:
          id: path.id
      - text: Remove the distribution profile with UUID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'