# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Device Settings Device Context Segment Association API
  version: 1.0.0
extends: openapi/palo-alto-networks-device-context-segment-association-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['/device-context-segment-association'].get
  update:
    x-apievangelist-phrasing:
      intent: List device context segment associations
      effect: read
      questions:
      - Which device context segment associations are configured?
      - Can I page through segment associations or filter them by name?
      instructions:
      - text: List all device context segment associations.
      - text: Find device context segment associations named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/device-context-segment-association'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a device context segment association
      effect: write
      questions:
      - How do I add a new device context segment association?
      - What's required to create a segment association?
      instructions:
      - text: Create a device context segment association called {name}.
        slots:
          name: requestBody.name
      - text: Add a new segment association named {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/device-context-segment-association'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete segment associations by name
      effect: destructive
      questions:
      - Can I delete device context segment associations using their name instead of an ID?
      - How do I remove several segment associations that share a name?
      instructions:
      - text: Delete the device context segment associations named {name}.
        slots:
          name: query.name
      - text: 'Remove segment associations by name: {name}.'
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/device-context-segment-association/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device context segment association
      effect: read
      questions:
      - What does a specific device context segment association look like?
      - Can I fetch one segment association by its UUID?
      instructions:
      - text: Get device context segment association {id}.
        slots:
          id: path.id
      - text: Show the segment association with UUID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/device-context-segment-association/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a device context segment association
      effect: write
      questions:
      - How do I rename an existing device context segment association?
      - Can I edit a segment association after it's created?
      instructions:
      - text: Rename device context segment association {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Update the existing segment association {id} with name {name}.
        slots:
          id: path.id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/device-context-segment-association/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a segment association by ID
      effect: destructive
      questions:
      - How do I delete one specific segment association by its UUID?
      - Can a single device context segment association be removed by ID?
      instructions:
      - text: Delete device context segment association {id}.
        slots:
          id: path.id
      - text: Remove the segment association with UUID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'