Palo Alto Networks Account Groups API

You can use Account Groups to combine access to multiple cloud accounts with similar or different applications that span multiple divisions or business units, so that you can manage administrative access to these accounts from Prisma Cloud. When you onboard a cloud account to Prisma Cloud, you can assign the cloud account to one or more account groups, and then assign the account group to Prisma Cloud Administrator Roles. Assigning an account group to an administrative user on Prisma Cloud allows you to restrict access only to the resources and data that pertains to the cloud account(s) within an account group. Alerts on Prisma Cloud are applied at the cloud account group level, which means you can set up separate alert rules and notification flows for different cloud environments.

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /cloud/group List account groups with details · List Account Groups #
Ask an LLM
“Which account groups can I access in Prisma Cloud?”
“Can I list account groups without all the cloud account details attached?”
Tell an agent
List all account groups I have access to.
List account groups with excludeCloudAccountDetails set to {excludeCloudAccountDetails}.
POST /cloud/group Create an account group · Add Account Group #
Ask an LLM
“How do I group several cloud accounts together in Prisma Cloud?”
“Can I set a description when creating a new account group?”
Tell an agent
Create account group {name} containing accounts {accountIds}.
Make a new account group {name} for accounts {accountIds} described as {description}.
GET /cloud/group/name List account group IDs and names · List Account Group Names #
Ask an LLM
“What are the names and IDs of all my account groups?”
“Which account groups were created automatically?”
Tell an agent
Give me just the IDs and names of my account groups.
List account group names with auto-created groups included: {include_auto_created}.
GET /cloud/group/name/{cloud_type} List account group names for a cloud type · List Account Group Names by Cloud Type #
Ask an LLM
“Which account groups contain AWS accounts versus Azure or GCP?”
“Can I filter account group names by cloud provider type?”
Tell an agent
List account group names for cloud type {cloud_type}.
Show only the {cloud_type} account groups.
GET /cloud/group/{id} Get an account group's details · Account Group Info #
Ask an LLM
“What cloud accounts belong to a specific account group?”
“Can I see everything about one account group by its ID?”
Tell an agent
Show account group {id}.
Get account group {id} including account info {includeAccountInfo}.
PUT /cloud/group/{id} Update an account group · Update Account Group #
Ask an LLM
“How do I add or remove cloud accounts from an existing account group?”
“Can I rename an account group?”
Tell an agent
Set the accounts in group {id} to {accountIds}, keeping name {name}.
Rename account group {id} to {name}.
DELETE /cloud/group/{id} Delete an account group · Delete Account Group #
Ask an LLM
“How do I remove an account group I no longer need?”
“Can an account group be deleted by its ID?”
Tell an agent destructive · confirm first
Delete account group {id}.
Remove the account group with ID {id}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/palo-alto-networks:palo-alto-networks-account-groups-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

palo-alto-networks-account-groups-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  contact: {}
  description: 'Access Keys are a secure way to enable programmatic access to the Prisma Cloud API. By default, only

    the System Admin has API access and can enable API access for other administrators. If you have API access,

    you can create up to two access keys. Create an access key for a limited time period and regenerate your API

    keys periodically to minimize exposure and follow security best practices.'
  title: Prisma Cloud Access Keys API Overview Account Groups API
  version: Latest
servers:
- url: https://api.prismacloud.io
- url: https://api2.prismacloud.io
- url: https://api3.prismacloud.io
- url: https://api4.prismacloud.io
tags:
- description: 'You can use Account Groups to combine access to multiple cloud accounts with similar or different applications

    that span multiple divisions or business units, so that you can manage administrative access to these accounts

    from Prisma Cloud.'
  name: Account Groups
paths:
  /cloud/group:
    get:
      description: Returns an array of accessible account groups.
      operationId: get-account-groups
      parameters:
      - description: true = Exclude cloud account details. Default is false.
        in: query
        name: excludeCloudAccountDetails
        required: false
        schema:
          type: boolean
      responses:
        '200':
          content:
            application/json; charset=UTF-8:
              schema:
                items:
                  $ref: '#/components/schemas/AccountGroupViewModel'
                type: array
          description: successful operation
        '500':
          description: internal_error
      security:
      - x-redlock-auth: []
      summary: List Account Groups
      tags:
      - Account Groups
    post:
      description: Create a new account group on the Prisma Cloud platform.
      operationId: add-account-group
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountGroupModel'
        description: Account Group
        required: true
      responses:
        '200':
          content:
            application/json; charset=UTF-8:
              schema:
                $ref: '#/components/schemas/AccountGroupModel'
          description: successful operation
        '400':
          description: invalid_account_group_name / account_group_name_already_exists / invalid_account_ids
        '403':
          description: unauthorized_access
        '500':
          description: internal_error
      security:
      - x-redlock-auth: []
      summary: Add Account Group
      tags:
      - Account Groups
  /cloud/group/name:
    get:
      description: Returns list of account group IDs, names, and whether or not the group was created automatically.
      operationId: get-account-group-name
      parameters:
      - description: Include account groups that were automatically created during cloud onboarding. Default is true.
        in: query
        name: include_auto_created
        required: false
        schema:
          type: boolean
      responses:
        '200':
          content:
            application/json; charset=UTF-8:
              schema:
                items:
                  $ref: '#/components/schemas/AccountGroupMetadataViewModel'
                type: array
          description: successful operation
        '500':
          description: internal_error
      security:
      - x-redlock-auth: []
      summary: List Account Group Names
      tags:
      - Account Groups
  /cloud/group/name/{cloud_type}:
    get:
      description: Returns list of account group IDs and names filtered by cloud type.
      operationId: get-account-group-name-by-cloudType
      parameters:
      - description: Cloud Type
        in: path
        name: cloud_type
        required: true
        schema:
          enum:
          - aws
          - azure
          - gcp
          - alibaba_cloud
          - oci
          type: string
      responses:
        '200':
          content:
            application/json; charset=UTF-8:
              schema:
                items:
                  additionalProperties:
                    type: object
                  type: object
                type: array
          description: successful operation
        '500':
          description: internal_error
      security:
      - x-redlock-auth: []
      summary: List Account Group Names by Cloud Type
      tags:
      - Account Groups
  /cloud/group/{id}:
    get:
      description: Retrieve all information about an account group using its ID.
      operationId: get-account-group
      parameters:
      - description: Account Group ID
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: true = Include cloud account information. Default is false.
        in: query
        name: includeAccountInfo
        required: false
        schema:
          type: boolean
      responses:
        '200':
          content:
            application/json; charset=UTF-8:
              schema:
                $ref: '#/components/schemas/AccountGroupModel'
          description: successful operation
        '403':
          description: unauthorized_access
        '500':
          description: internal_error
      security:
      - x-redlock-auth: []
      summary: Account Group Info
      tags:
      - Account Groups
    put:
      description: Update information related to an existing account group.
      operationId: update-account-group
      parameters:
      - description: Account Group ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountGroupModel'
        description: Account Group
        required: true
      responses:
        '200':
          description: successful operation
        '400':
          description: invalid_account_group_name / invalid_id / account_group_name_already_exists
        '403':
          description: unauthorized_access
        '500':
          description: internal_error
      security:
      - x-redlock-auth: []
      summary: Update Account Group
      tags:
      - Account Groups
    delete:
      description: Deletes an existing account group using its ID.
      operationId: delete-account-group
      parameters:
      - description: Account Group ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
        '400':
          description: invalid_id
        '403':
          description: unauthorized_access
        '409':
          description: conflict_deleting_last_account_group_for_alert_rule / cannot_delete_an_account_group_associated_with_cloud_accounts
        '500':
          description: internal_error
      security:
      - x-redlock-auth: []
      summary: Delete Account Group
      tags:
      - Account Groups
components:
  schemas:
    CustomAlertRule:
      properties:
        alertId:
          type: string
        alertName:
          type: string
      type: object
    AccountGroupModel:
      description: Model for Account Group
      properties:
        accountIds:
          description: Cloud Account IDs
          items:
            type: string
          type: array
        autoCreated:
          description: Boolean read-only attribute to indicate if account group is automatically created
          readOnly: true
          type: boolean
        cloudAccountCount:
          description: Number of cloud accounts associated with this account group
          format: int32
          readOnly: true
          type: integer
        cloudAccountInfos:
          description: Cloud account details of account associated with this account group
          items:
            $ref: '#/components/schemas/CloudAccountInfo'
          readOnly: true
          type: array
        description:
          description: Description
          type: string
        id:
          description: Account Group ID
          readOnly: true
          type: string
        lastModifiedBy:
          description: Last Modified By
          readOnly: true
          type: string
        lastModifiedTs:
          description: Last Modified Time
          format: int64
          readOnly: true
          type: integer
        name:
          description: Name
          type: string
      required:
      - accountIds
      - name
      type: object
    AccountGroupMetadataViewModel:
      properties:
        autoCreated:
          description: Boolean to indicate if account group is automatically created
          type: boolean
        id:
          description: Account Group ID
          type: string
        name:
          description: Name
          type: string
      required:
      - name
      type: object
    AccountGroupViewModel:
      description: Model for Account Group View
      properties:
        accountIds:
          description: Cloud Account IDs
          items:
            type: string
          type: array
        accounts:
          description: Associated Cloud Accounts
          items:
            additionalProperties:
              type: string
            type: object
          readOnly: true
          type: array
        alertRules:
          description: Singly associated alert rules which cannot exist in the system without the account group
          items:
            $ref: '#/components/schemas/CustomAlertRule'
          readOnly: true
          type: array
        autoCreated:
          description: Boolean read-only attribute to indicate if account group is automatically created
          readOnly: true
          type: boolean
        cloudAccountCount:
          description: Number of cloud accounts associated with this account group
          format: int32
          readOnly: true
          type: integer
        cloudAccountInfos:
          description: Cloud account details of account associated with this account group
          items:
            $ref: '#/components/schemas/CloudAccountInfo'
          readOnly: true
          type: array
        description:
          description: Description
          type: string
        id:
          description: Account Group ID
          readOnly: true
          type: string
        lastModifiedBy:
          description: Last Modified By
          readOnly: true
          type: string
        lastModifiedTs:
          description: Last Modified Time
          format: int64
          readOnly: true
          type: integer
        name:
          description: Name
          type: string
        parentInfo:
          allOf:
          - $ref: '#/components/schemas/AccountGroupMetadataViewModel'
          - description: For future use
      required:
      - accountIds
      - name
      type: object
    CloudAccountInfo:
      description: Cloud account info linked to an account group
      properties:
        accountId:
          description: Account ID
          type: string
        cloudType:
          description: Cloud Type
          enum:
          - ALL
          - AWS
          - AZURE
          - GCP
          - ALIBABA_CLOUD
          - OCI
          - OTHER
          type: string
        lastModifiedBy:
          description: Last Modified By
          type: string
      type: object
  securitySchemes:
    x-redlock-auth:
      description: The x-redlock-auth value is a JSON Web Token (JWT).
      in: header
      name: x-redlock-auth
      type: apiKey