# 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) MSSP…'
  version: 1.0.0
extends: openapi/palo-alto-networks-mssp-managed-tenant-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: 6
- target: $.paths['/api/v1/mssp/{mssp-id}/managed-tenant'].get
  update:
    x-apievangelist-phrasing:
      intent: List an MSSP's managed tenants
      effect: read
      questions:
      - Which tenants does my MSSP manage?
      - Can I filter managed tenants by tenant group, or include deleted ones?
      - How do I show the synthetic tenant in my MSSP's tenant list?
      instructions:
      - text: List the managed tenants of MSSP {mssp_id}.
        slots:
          mssp_id: path.mssp-id
      - text: List MSSP {mssp_id} tenants in tenant group {tenant_group}.
        slots:
          mssp_id: path.mssp-id
          tenant_group: query.tenant_group
      - text: Continue listing MSSP {mssp_id} managed tenants from 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}/managed-tenant'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a managed tenant for an MSSP
      effect: write
      questions:
      - How do I onboard a new customer tenant under my MSSP?
      - What region, plan and license info does a new managed tenant need?
      instructions:
      - text: Create managed tenant {name} for {companyName} under MSSP {mssp_id} in region {region} on plan {planType} with contact {contactInfo} and license {licenseInfo}.
        slots:
          name: requestBody.name
          companyName: requestBody.companyName
          mssp_id: path.mssp-id
          region: requestBody.region
          planType: requestBody.planType
          contactInfo: requestBody.contactInfo
          licenseInfo: requestBody.licenseInfo
      - text: 'Onboard {companyName} as tenant {name} for MSSP {mssp_id}: region {region}, plan {planType}, contact {contactInfo}, license {licenseInfo}, modules {modules}.'
        slots:
          companyName: requestBody.companyName
          name: requestBody.name
          mssp_id: path.mssp-id
          region: requestBody.region
          planType: requestBody.planType
          contactInfo: requestBody.contactInfo
          licenseInfo: requestBody.licenseInfo
          modules: requestBody.modules
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/managed-tenant/{tenant-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed tenant's details
      effect: read
      questions:
      - What details are stored for one of my managed tenants?
      - Can I look up a managed tenant by its external tenant ID instead of the Prisma ID?
      instructions:
      - text: Get managed tenant {tenant_id} of MSSP {mssp_id}.
        slots:
          tenant_id: path.tenant-id
          mssp_id: path.mssp-id
      - text: Show license and module details for tenant {tenant_id} under MSSP {mssp_id}.
        slots:
          tenant_id: path.tenant-id
          mssp_id: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/managed-tenant/{tenant-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Mark a managed tenant as deleted
      effect: destructive
      questions:
      - Can I offboard a customer tenant from my MSSP?
      - Is deleting a managed tenant a soft delete that still shows with deleted tenants?
      instructions:
      - text: Delete managed tenant {tenant_id} from MSSP {mssp_id}.
        slots:
          tenant_id: path.tenant-id
          mssp_id: path.mssp-id
      - text: Mark tenant {tenant_id} under MSSP {mssp_id} as deleted.
        slots:
          tenant_id: path.tenant-id
          mssp_id: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/managed-tenant/{tenant-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Modify a managed tenant
      effect: write
      questions:
      - Can I move a managed tenant into a different tenant group?
      - Is it possible to change the licensed modules on a customer tenant?
      instructions:
      - text: Move tenant {tenant_id} of MSSP {mssp_id} to tenant group {tenantGroupId}.
        slots:
          tenant_id: path.tenant-id
          mssp_id: path.mssp-id
          tenantGroupId: requestBody.tenantGroupId
      - text: Update license {licenseInfo} and modules {modules} for tenant {tenant_id} under MSSP {mssp_id}.
        slots:
          licenseInfo: requestBody.licenseInfo
          modules: requestBody.modules
          tenant_id: path.tenant-id
          mssp_id: path.mssp-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/mssp/{mssp-id}/managed-tenant/{tenant-id}/login'].get
  update:
    x-apievangelist-phrasing:
      intent: Log in to a managed tenant seamlessly
      effect: read
      questions:
      - Can I jump straight into a customer's tenant without separate credentials?
      - Which page will I land on after a seamless login to a managed tenant?
      instructions:
      - text: Log me into managed tenant {tenant_id} of MSSP {mssp_id}.
        slots:
          tenant_id: path.tenant-id
          mssp_id: path.mssp-id
      - text: Open tenant {tenant_id} under MSSP {mssp_id} on landing page {landing_page}.
        slots:
          tenant_id: path.tenant-id
          mssp_id: path.mssp-id
          landing_page: query.landing_page
      method: generated
      generated: '2026-09-26'