# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Cloud Access Keys API Overview Account Groups API
  version: 1.0.0
extends: openapi/palo-alto-networks-account-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: 7
- target: $.paths['/cloud/group'].get
  update:
    x-apievangelist-phrasing:
      intent: List account groups with details
      effect: read
      questions:
      - Which account groups can I access in Prisma Cloud?
      - Can I list account groups without all the cloud account details attached?
      instructions:
      - text: List all account groups I have access to.
      - text: List account groups with excludeCloudAccountDetails set to {excludeCloudAccountDetails}.
        slots:
          excludeCloudAccountDetails: query.excludeCloudAccountDetails
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/group'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an account group
      effect: write
      questions:
      - How do I group several cloud accounts together in Prisma Cloud?
      - Can I set a description when creating a new account group?
      instructions:
      - text: Create account group {name} containing accounts {accountIds}.
        slots:
          name: requestBody.name
          accountIds: requestBody.accountIds
      - text: Make a new account group {name} for accounts {accountIds} described as {description}.
        slots:
          name: requestBody.name
          accountIds: requestBody.accountIds
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/group/name'].get
  update:
    x-apievangelist-phrasing:
      intent: List account group IDs and names
      effect: read
      questions:
      - What are the names and IDs of all my account groups?
      - Which account groups were created automatically?
      instructions:
      - text: Give me just the IDs and names of my account groups.
      - text: 'List account group names with auto-created groups included: {include_auto_created}.'
        slots:
          include_auto_created: query.include_auto_created
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/group/name/{cloud_type}'].get
  update:
    x-apievangelist-phrasing:
      intent: List account group names for a cloud type
      effect: read
      questions:
      - Which account groups contain AWS accounts versus Azure or GCP?
      - Can I filter account group names by cloud provider type?
      instructions:
      - text: List account group names for cloud type {cloud_type}.
        slots:
          cloud_type: path.cloud_type
      - text: Show only the {cloud_type} account groups.
        slots:
          cloud_type: path.cloud_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/group/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an account group's details
      effect: read
      questions:
      - What cloud accounts belong to a specific account group?
      - Can I see everything about one account group by its ID?
      instructions:
      - text: Show account group {id}.
        slots:
          id: path.id
      - text: Get account group {id} including account info {includeAccountInfo}.
        slots:
          id: path.id
          includeAccountInfo: query.includeAccountInfo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/group/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an account group
      effect: write
      questions:
      - How do I add or remove cloud accounts from an existing account group?
      - Can I rename an account group?
      instructions:
      - text: Set the accounts in group {id} to {accountIds}, keeping name {name}.
        slots:
          id: path.id
          accountIds: requestBody.accountIds
          name: requestBody.name
      - text: Rename account group {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/group/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an account group
      effect: destructive
      questions:
      - How do I remove an account group I no longer need?
      - Can an account group be deleted by its ID?
      instructions:
      - text: Delete account group {id}.
        slots:
          id: path.id
      - text: Remove the account group with ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'