# 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: Managed Security Service Provider (MSSP)…'
  version: 1.0.0
extends: openapi/palo-alto-networks-policy-group-lifecycle-endpoints-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: 5
- target: $.paths['/api/v1/mssp/{mssp-id}/policy-group/{pg-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an MSSP policy group
      effect: read
      questions:
      - What policies are in a specific policy group for my MSSP tenant?
      - Can I look up one policy group by its ID?
      instructions:
      - text: Show policy group {pg_id} for MSSP {mssp_id}.
        slots:
          pg_id: path.pg-id
          mssp_id: path.mssp-id
      - text: List the policies assigned to policy group {pg_id} under MSSP {mssp_id}.
        slots:
          pg_id: path.pg-id
          mssp_id: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/policy-group/{pg-id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an MSSP policy group
      effect: write
      questions:
      - How do I change the policies assigned to an existing policy group?
      - Can I rename a policy group in my MSSP account?
      instructions:
      - text: Rename policy group {pg_id} under MSSP {mssp_id} to {name}.
        slots:
          pg_id: path.pg-id
          mssp_id: path.mssp-id
          name: requestBody.name
      - text: Set the policies of group {pg_id} ({name}) in MSSP {mssp_id} to {policies}.
        slots:
          pg_id: path.pg-id
          mssp_id: path.mssp-id
          name: requestBody.name
          policies: requestBody.policies
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/policy-group/{pg-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an empty MSSP policy group
      effect: destructive
      questions:
      - How do I delete a policy group from my MSSP account?
      - Can I delete a policy group that still has policies in it, or must it be empty?
      instructions:
      - text: Delete policy group {pg_id} from MSSP {mssp_id}.
        slots:
          pg_id: path.pg-id
          mssp_id: path.mssp-id
      - text: Remove the empty policy group {pg_id} under MSSP {mssp_id}.
        slots:
          pg_id: path.pg-id
          mssp_id: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/policy-group'].get
  update:
    x-apievangelist-phrasing:
      intent: List all MSSP policy groups
      effect: read
      questions:
      - Which policy groups exist across my MSSP tenant groups?
      - How do I page through all policy groups with a page token?
      instructions:
      - text: List all policy groups for MSSP {mssp_id}.
        slots:
          mssp_id: path.mssp-id
      - text: Get the next page of policy groups for MSSP {mssp_id} using token {next_page_token}.
        slots:
          mssp_id: path.mssp-id
          next_page_token: query.next_page_token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/policy-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an MSSP policy group
      effect: write
      questions:
      - How do I create a new policy group for my managed tenants?
      - Can I assign policies to a policy group when I create it?
      instructions:
      - text: Create policy group {name} under MSSP {mssp_id}.
        slots:
          mssp_id: path.mssp-id
          name: requestBody.name
      - text: Create a new policy group {name} in MSSP {mssp_id} containing policies {policies}.
        slots:
          mssp_id: path.mssp-id
          name: requestBody.name
          policies: requestBody.policies
      method: generated
      generated: '2026-09-26'