# 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-tenant-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}/tenant-group'].get
  update:
    x-apievangelist-phrasing:
      intent: List an MSSP's tenant groups
      effect: read
      questions:
      - Which tenant groups has my MSSP created for its managed tenants?
      - Can I page through an MSSP's tenant groups with a token?
      instructions:
      - text: List tenant groups for MSSP {mssp-id}.
        slots:
          mssp-id: path.mssp-id
      - text: Get the next page of MSSP {mssp-id} tenant groups 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}/tenant-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an MSSP tenant group
      effect: write
      questions:
      - How do I group several managed tenants together as an MSSP?
      - Can I add tenants to a tenant group at the moment I create it?
      instructions:
      - text: Create tenant group {groupName} under MSSP {mssp-id}.
        slots:
          groupName: requestBody.groupName
          mssp-id: path.mssp-id
      - text: Create group {groupName} for MSSP {mssp-id} containing tenants {tenantIds}.
        slots:
          groupName: requestBody.groupName
          mssp-id: path.mssp-id
          tenantIds: requestBody.tenantIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/tenant-group/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an MSSP tenant group
      effect: read
      questions:
      - Which managed tenants belong to a specific tenant group?
      - Can I look up a single MSSP tenant group by its ID?
      instructions:
      - text: Get tenant group {id} for MSSP {mssp-id}.
        slots:
          id: path.id
          mssp-id: path.mssp-id
      - text: Show the tenants in group {id} of MSSP {mssp-id}.
        slots:
          id: path.id
          mssp-id: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/tenant-group/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an empty MSSP tenant group
      effect: destructive
      questions:
      - Can I delete a tenant group that still contains tenants?
      - What must be true before an MSSP tenant group can be removed?
      instructions:
      - text: Delete empty tenant group {id} from MSSP {mssp-id}.
        slots:
          id: path.id
          mssp-id: path.mssp-id
      - text: Remove tenant group {id} under MSSP {mssp-id}.
        slots:
          id: path.id
          mssp-id: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/tenant-group/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Modify an MSSP tenant group
      effect: write
      questions:
      - Can I rename a tenant group or change which tenants it holds?
      - Is it possible to move managed tenants into an existing group?
      instructions:
      - text: Rename tenant group {id} of MSSP {mssp-id} to {groupName}.
        slots:
          id: path.id
          mssp-id: path.mssp-id
          groupName: requestBody.groupName
      - text: Set tenant group {id} ({groupName}) under MSSP {mssp-id} to tenants {tenantIds}.
        slots:
          id: path.id
          groupName: requestBody.groupName
          mssp-id: path.mssp-id
          tenantIds: requestBody.tenantIds
      method: generated
      generated: '2026-09-26'