# 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-to-tenant-group-management-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: 2
- target: $.paths['/api/v1/mssp/{mssp-id}/tenant-group-policy-group-mapping'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign policy groups to a tenant group
      effect: write
      questions:
      - How do I apply a set of policy groups to one of my MSSP tenant groups?
      - Can I map several policy groups to a tenant group in one request?
      instructions:
      - text: Assign policy group mappings {mappings} for MSSP {mssp-id}.
        slots:
          mappings: requestBody.mappings
          mssp-id: path.mssp-id
      - text: Map policy groups to tenant groups with {mappings} under MSSP {mssp-id}.
        slots:
          mappings: requestBody.mappings
          mssp-id: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/tenant-group-policy-group-mapping/{mapping-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a policy group from a tenant group
      effect: destructive
      questions:
      - How do I detach a policy group from a tenant group?
      - Is removing a policy group association from a tenant group reversible?
      instructions:
      - text: Delete mapping {mapping-id} for MSSP {mssp-id}.
        slots:
          mapping-id: path.mapping-id
          mssp-id: path.mssp-id
      - text: Remove the policy group association {mapping-id} from its tenant group under MSSP {mssp-id}.
        slots:
          mapping-id: path.mapping-id
          mssp-id: path.mssp-id
      method: generated
      generated: '2026-09-26'