# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Objects Dynamic User Groups API
  version: 1.0.0
extends: openapi/palo-alto-networks-dynamic-user-groups-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: 10
- target: $.paths['/dynamic-user-groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List dynamic user groups
      effect: read
      questions:
      - Which dynamic user groups are defined in my configuration?
      - Can I find dynamic user groups in a specific folder or snippet?
      instructions:
      - text: List the dynamic user groups in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the dynamic user group named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dynamic-user-groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a dynamic user group
      effect: write
      questions:
      - How do I create a user group whose membership is driven by tags?
      - Can I define a dynamic user group with a tag-based filter?
      instructions:
      - text: Create dynamic user group {name} with ID {id} and filter {filter}.
        slots:
          name: requestBody.name
          id: requestBody.id
          filter: requestBody.filter
      - text: Add dynamic user group {name} (ID {id}) matching {filter}, described as {description}.
        slots:
          name: requestBody.name
          id: requestBody.id
          filter: requestBody.filter
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dynamic-user-groups/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dynamic user group
      effect: read
      questions:
      - What filter does a particular dynamic user group use?
      - Can I look up a dynamic user group by ID?
      instructions:
      - text: Show dynamic user group {id}.
        slots:
          id: path.id
      - text: Get the membership filter of dynamic user group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dynamic-user-groups/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a dynamic user group
      effect: write
      questions:
      - How do I change the filter on an existing dynamic user group?
      - Can I rename a dynamic user group?
      instructions:
      - text: Change the filter on dynamic user group {id} named {name} to {filter}.
        slots:
          id: path.id
          name: requestBody.name
          filter: requestBody.filter
      - text: Rename dynamic user group {id} to {name}, keeping filter {filter}.
        slots:
          id: path.id
          name: requestBody.name
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dynamic-user-groups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a dynamic user group
      effect: destructive
      questions:
      - How do I remove a dynamic user group?
      - Can a dynamic user group be deleted by ID?
      instructions:
      - text: Delete dynamic user group {id}.
        slots:
          id: path.id
      - text: Remove the dynamic user group with ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/config/v1/dynamic-user-groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List dynamic user groups in a folder
      effect: read
      questions:
      - What dynamic user groups are defined in a Prisma Access folder?
      - Can I look up a dynamic user group by name?
      instructions:
      - text: List dynamic user groups in folder {folder} through the SSE config v1 path.
        slots:
          folder: query.folder
      - text: Find dynamic user group {name} in folder {folder}.
        slots:
          name: query.name
          folder: query.folder
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/dynamic-user-groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a tag-based dynamic user group
      effect: write
      questions:
      - How do I create a user group whose membership follows user tags?
      - Can I tag a dynamic user group object when I create it?
      instructions:
      - text: Create dynamic user group {name} in {folder} with tag filter {filter}.
        slots:
          name: requestBody.name
          folder: query.folder
          filter: requestBody.filter
      - text: Add dynamic user group {name} in {folder} matching {filter}, tagged {tag}.
        slots:
          name: requestBody.name
          folder: query.folder
          filter: requestBody.filter
          tag: requestBody.tag
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/dynamic-user-groups/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dynamic user group
      effect: read
      questions:
      - Where can I see one dynamic user group's filter?
      - What tag filter defines a given dynamic user group?
      instructions:
      - text: Get dynamic user group {id}.
        slots:
          id: path.id
      - text: Show the tag filter of dynamic user group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/dynamic-user-groups/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a dynamic user group
      effect: write
      questions:
      - How do I change the tag filter of an existing dynamic user group?
      - Can I rename a dynamic user group after creating it?
      instructions:
      - text: Change dynamic user group {id} filter to {filter}, name {name}.
        slots:
          id: path.id
          filter: requestBody.filter
          name: requestBody.name
      - text: Update the description of dynamic user group {id} to {description}.
        slots:
          id: path.id
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/dynamic-user-groups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a dynamic user group
      effect: destructive
      questions:
      - Can I remove a dynamic user group from Prisma Access?
      - Is deleting a dynamic user group permanent?
      instructions:
      - text: Delete dynamic user group {id} using the SSE config v1 endpoint.
        slots:
          id: path.id
      - text: Remove the dynamic user group with ID {id} through the SSE config v1 path.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'