# 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 Groups API
  version: 1.0.0
extends: openapi/palo-alto-networks-groups-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: 10
- target: $.paths['/api/v34.03/groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List user groups (v34.03)
      effect: read
      questions:
      - Which user groups are defined in Compute, per the v34.03 API?
      - Can I see group roles and permissions using version 34.03?
      instructions:
      - text: List all user groups with the v34.03 API.
      - text: Show groups and their roles via the older v34.03 endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a user group (v34.03)
      effect: write
      questions:
      - Can I create a group mapped to an LDAP or SAML group on v34.03?
      - What fields does a new group take in the v34.03 API?
      instructions:
      - text: Add group {groupName} with role {role} using v34.03.
        slots:
          groupName: requestBody.groupName
          role: requestBody.role
      - text: Create a v34.03 group {groupName} linked to the SAML group.
        slots:
          groupName: requestBody.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/groups/names'].get
  update:
    x-apievangelist-phrasing:
      intent: List group names (v34.03)
      effect: read
      questions:
      - Can I get just group names with the older v34.03 endpoint?
      - Which group names exist in version 34.03?
      instructions:
      - text: List only the group names, API v34.03.
      - text: Return group names from v34.03 without details.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/groups/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a user group (v34.03)
      effect: write
      questions:
      - Can I change a group's role through the v34.03 API?
      - How are group permissions edited on version 34.03?
      instructions:
      - text: Update v34.03 group {id} to role {role}.
        slots:
          id: path.id
          role: requestBody.role
      - text: Rename group {id} to {groupName} using API v34.03.
        slots:
          id: path.id
          groupName: requestBody.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.03/groups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user group (v34.03)
      effect: destructive
      questions:
      - Can I remove a group with the v34.03 API?
      - Is deleting a group by ID supported in version 34.03?
      instructions:
      - text: Delete group {id} via v34.03.
        slots:
          id: path.id
      - text: Remove the v34.03 user group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List user groups
      effect: read
      questions:
      - Which user groups have access to Prisma Cloud Compute?
      - What role and permissions does each group carry?
      instructions:
      - text: List all user groups.
      - text: Show every group with its role and identity-provider mapping on v34.04.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a user group
      effect: write
      questions:
      - How do I create a group that maps to an OIDC or LDAP group?
      - Can a new group be given a role when I create it?
      instructions:
      - text: Create group {groupName}.
        slots:
          groupName: requestBody.groupName
      - text: Add a group {groupName} with role {role} on the current v34.04 API.
        slots:
          groupName: requestBody.groupName
          role: requestBody.role
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/groups/names'].get
  update:
    x-apievangelist-phrasing:
      intent: List group names
      effect: read
      questions:
      - Can I get a quick list of group names only?
      - What are the names of the groups I've defined?
      instructions:
      - text: List group names.
      - text: Give me the names of all groups, v34.04.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/groups/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a user group
      effect: write
      questions:
      - How do I change the role or permissions of an existing group?
      - Can I switch which LDAP group an existing group maps to?
      instructions:
      - text: Update group {id} to have role {role}.
        slots:
          id: path.id
          role: requestBody.role
      - text: Change the name of group {id} to {groupName} on v34.04.
        slots:
          id: path.id
          groupName: requestBody.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v34.04/groups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user group
      effect: destructive
      questions:
      - How do I delete a group that is no longer needed?
      - Can I remove a user group by its ID on v34.04?
      instructions:
      - text: Delete group {id}.
        slots:
          id: path.id
      - text: Remove user group {id} using the latest API version 34.04.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'