# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Palo Alto Networks Application Groups API
  version: 1.0.0
extends: openapi/palo-alto-networks-application-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: 15
- target: $.paths['/seb-api/v1/application-groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List Enterprise Browser application groups
      effect: read
      questions:
      - Which application groups are defined for the Enterprise Browser?
      - Can I see browser application groups from the draft configuration rather than the active one?
      - How do I page browser application groups with a cursor?
      instructions:
      - text: List browser application groups whose name contains {name}.
        slots:
          name: query.name
      - text: Show browser application groups in configuration version {configurationVersion}.
        slots:
          configurationVersion: query.configurationVersion
      - text: Get the next {limit} browser application groups after cursor {cursor}.
        slots:
          limit: query.limit
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/application-groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Enterprise Browser application group
      effect: write
      questions:
      - How do I group several browser applications under one name?
      - Can I give a new browser application group a description?
      instructions:
      - text: Create browser application group {name} containing apps {applications}.
        slots:
          name: requestBody.name
          applications: requestBody.applications
      - text: Add a browser application group {name} described as {description}.
        slots:
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/application-groups/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Enterprise Browser application group
      effect: read
      questions:
      - Which apps are members of a specific browser application group?
      - Can I read a browser application group as it stands in a given configuration version?
      instructions:
      - text: Get browser application group {id}.
        slots:
          id: path.id
      - text: Show browser application group {id} in configuration version {configurationVersion}.
        slots:
          id: path.id
          configurationVersion: query.configurationVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/application-groups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Enterprise Browser application group
      effect: destructive
      questions:
      - How do I permanently remove a browser application group?
      - Is deleting a browser application group reversible?
      instructions:
      - text: Delete browser application group {id}.
        slots:
          id: path.id
      - text: Permanently remove the browser app group with ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seb-api/v1/application-groups/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update a browser application group
      effect: write
      questions:
      - Can I change just the description of a browser application group and leave the rest?
      - How do I swap the member apps of a browser application group?
      instructions:
      - text: Patch browser application group {id} with description {description}.
        slots:
          id: path.id
          description: requestBody.description
      - text: Set the member apps of browser application group {id} to {applications}.
        slots:
          id: path.id
          applications: requestBody.applications
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List firewall application groups
      effect: read
      questions:
      - What application groups are defined in a folder, snippet or device configuration?
      - Can I filter security-policy application groups by name?
      instructions:
      - text: List application groups in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the policy application group named {name}.
        slots:
          name: query.name
      - text: Show application groups defined in snippet {snippet}.
        slots:
          snippet: query.snippet
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a firewall application group
      effect: write
      questions:
      - How do I bundle App-IDs into an application group for security rules?
      - What characters are allowed in a policy application group name?
      instructions:
      - text: Create policy application group {name} (UUID {id}) with members {members}.
        slots:
          name: requestBody.name
          id: requestBody.id
          members: requestBody.members
      - text: Make a configuration application group {name}, id {id}, grouping {members}.
        slots:
          name: requestBody.name
          id: requestBody.id
          members: requestBody.members
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-groups/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a firewall application group
      effect: read
      questions:
      - Which applications are in a given policy application group?
      - How do I fetch one configuration application group by UUID?
      instructions:
      - text: Get policy application group {id}.
        slots:
          id: path.id
      - text: Show the members of configuration application group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-groups/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a firewall application group
      effect: write
      questions:
      - Can I replace the full member list of a policy application group?
      - Do I need to resend the name and UUID when updating a configuration application group?
      instructions:
      - text: Update policy application group {path_id} to name {name}, id {id}, members {members}.
        slots:
          path_id: path.id
          name: requestBody.name
          id: requestBody.id
          members: requestBody.members
      - text: Overwrite the members of configuration application group {path_id} ({name}, {id}) with {members}.
        slots:
          path_id: path.id
          name: requestBody.name
          id: requestBody.id
          members: requestBody.members
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-groups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a firewall application group
      effect: destructive
      questions:
      - How do I delete a policy application group from my configuration?
      - Can I remove a configuration application group by its UUID?
      instructions:
      - text: Delete policy application group {id}.
        slots:
          id: path.id
      - text: Remove the configuration application group with UUID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/config/v1/application-groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List application groups in a folder
      effect: read
      questions:
      - What application groups exist in my Prisma Access configuration folder?
      - Can I find an application group by name?
      instructions:
      - text: List application groups in folder {folder} through the SSE config v1 endpoint.
        slots:
          folder: query.folder
      - text: Find application group {name} in folder {folder}.
        slots:
          name: query.name
          folder: query.folder
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/application-groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an application group
      effect: write
      questions:
      - How do I bundle several applications into one group for security policy?
      - Which folder does a new application group need to go in?
      instructions:
      - text: Create application group {name} with members {members} in folder {folder}.
        slots:
          name: requestBody.name
          members: requestBody.members
          folder: query.folder
      - text: Make a new app group {name} in {folder} containing {members}.
        slots:
          name: requestBody.name
          folder: query.folder
          members: requestBody.members
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/application-groups/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application group by ID
      effect: read
      questions:
      - Which applications are members of a specific application group?
      - How do I fetch one application group by its ID?
      instructions:
      - text: Show application group {id}.
        slots:
          id: path.id
      - text: List the members of application group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/application-groups/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an application group
      effect: write
      questions:
      - How do I add or remove apps from an existing application group?
      - Can I modify an application group in place by ID?
      instructions:
      - text: Update application group {id} with {entry}.
        slots:
          id: path.id
          entry: requestBody.entry
      - text: Edit the membership of app group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/application-groups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application group
      effect: destructive
      questions:
      - How do I remove an application group I no longer use?
      - Can I delete an application group by its ID?
      instructions:
      - text: Delete application group {id}.
        slots:
          id: path.id
      - text: Remove the app group with ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'