# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Browser for MSP Report API
  version: 1.0.0
extends: openapi/palo-alto-networks-report-api-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: 8
- target: $.paths['/mt/pab/report/count'].post
  update:
    x-apievangelist-phrasing:
      intent: Count security events for a tenant
      effect: read
      questions:
      - How many browser security events has my tenant recorded in total?
      - What's the overall security event count for a Prisma Access Browser tenant?
      instructions:
      - text: Get the total security event count for tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      - text: Count all browser security events in tenant service group {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/pab/report/extension_blocked'].post
  update:
    x-apievangelist-phrasing:
      intent: Report blocked browser extensions
      effect: read
      questions:
      - Which browser extensions were blocked for my users?
      - Can I get a report of extensions the browser refused to install?
      instructions:
      - text: Show the blocked extension report for tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      - text: List browser extensions that were blocked in tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/pab/report/extension_category'].post
  update:
    x-apievangelist-phrasing:
      intent: Report browser extensions by category
      effect: read
      questions:
      - What kinds of browser extensions are my users running, grouped by category?
      - Is there a breakdown of extension usage by extension type?
      instructions:
      - text: Get the extension category report for tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      - text: Break down browser extensions by category for tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/pab/report/malicious_website'].post
  update:
    x-apievangelist-phrasing:
      intent: Report malicious websites detected
      effect: read
      questions:
      - Which malicious websites did the browser detect for my tenant?
      - Can I see a report of malicious sites detected when users hit?
      instructions:
      - text: Show the malicious website report for tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      - text: List malicious sites detected in tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/pab/report/malware_blocked'].post
  update:
    x-apievangelist-phrasing:
      intent: Report blocked malware
      effect: read
      questions:
      - How much malware did the browser block for my users?
      - Where can I see which malware downloads were stopped?
      instructions:
      - text: Get the blocked malware report for tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      - text: List malware that was blocked in tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/pab/report/malware_website'].post
  update:
    x-apievangelist-phrasing:
      intent: Report websites identified as malware sources
      effect: read
      questions:
      - Which websites were flagged as sources of malware?
      - Can I list the domains identified as distributing malware to my users?
      instructions:
      - text: Show the malware source website report for tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      - text: List sites identified as malware sources in tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/pab/report/website_blocked'].post
  update:
    x-apievangelist-phrasing:
      intent: Report blocked websites
      effect: read
      questions:
      - Which websites did the browser block for my users?
      - How do I get a report of sites that were denied by policy?
      instructions:
      - text: Get the blocked website report for tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      - text: List websites that were blocked in tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mt/pab/report/website_category'].post
  update:
    x-apievangelist-phrasing:
      intent: Report website access by category
      effect: read
      questions:
      - What categories of websites are my users visiting most?
      - Can I see browsing activity grouped by website type?
      instructions:
      - text: Show the website category report for tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      - text: Break down website access by category for tenant {tsg_id}.
        slots:
          tsg_id: requestBody.tsg_id
      method: generated
      generated: '2026-09-26'