# 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 Access Keys API Overview Policy API
  version: 1.0.0
extends: openapi/palo-alto-networks-policy-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: 11
- target: $.paths['/filter/policy/suggest'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported policy filters and default options
      effect: read
      questions:
      - Which filters can I use when listing Prisma Cloud policies?
      - What default or recent values are offered for each policy filter?
      instructions:
      - text: Show me all supported policy filters and their default options.
      - text: List the policy filter keys I can search on.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/filter/policy/suggest'].post
  update:
    x-apievangelist-phrasing:
      intent: Autocomplete values for a policy filter
      effect: read
      questions:
      - What values are available for a specific policy filter like compliance standard?
      - Can I fuzzy-search the options of a policy filter as I type?
      instructions:
      - text: Suggest values for policy filter {filterName}.
        slots:
          filterName: requestBody.filterName
      - text: Autocomplete {query} for policy filter {filterName}.
        slots:
          query: requestBody.query
          filterName: requestBody.filterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/policy'].get
  update:
    x-apievangelist-phrasing:
      intent: List policies (v1)
      effect: read
      questions:
      - Which high-severity policies are enabled in Prisma Cloud?
      - Can I list policies mapped to a particular compliance standard with the original endpoint?
      instructions:
      - text: List v1 policies with severity {severity} for cloud {cloud}.
        slots:
          severity: query.policy.severity
          cloud: query.cloud.type
      - text: Using the original policy list, show policies for compliance standard {standard}.
        slots:
          standard: query.policy.complianceStandard
      method: generated
      generated: '2026-09-26'
- target: $.paths['/policy'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom policy
      effect: write
      questions:
      - How do I create my own custom policy with a rule and severity?
      - Can I attach compliance metadata and labels to a new custom policy?
      instructions:
      - text: Create a {policyType} policy named {name} with severity {severity} and rule {rule}.
        slots:
          policyType: requestBody.policyType
          name: requestBody.name
          severity: requestBody.severity
          rule: requestBody.rule
      - text: Add custom policy {name} labeled {labels} with recommendation {recommendation}.
        slots:
          name: requestBody.name
          labels: requestBody.labels
          recommendation: requestBody.recommendation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/policy'].get
  update:
    x-apievangelist-phrasing:
      intent: List policies (v2, faster)
      effect: read
      questions:
      - Is there a faster way to list policies that also lets me filter by rule type and subtype?
      - Can the v2 policy list include deleted policies?
      instructions:
      - text: List v2 policies with rule type {ruleType} and subtype {subtype}.
        slots:
          ruleType: query.policy.rule.type
          subtype: query.policy.subtype
      - text: With the v2 list, show remediable policies for cloud {cloud}.
        slots:
          cloud: query.cloud.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/policy/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a policy by ID
      effect: read
      questions:
      - What rule, severity and remediation does a specific policy have?
      - How do I fetch one policy's full definition?
      instructions:
      - text: Get policy {id}.
        slots:
          id: path.id
      - text: Show the rule and remediation for policy {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/policy/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing policy
      effect: write
      questions:
      - Can I change the severity or rule of an existing policy?
      - Do I have to send every field when editing a policy?
      instructions:
      - text: Change the severity of policy {id} to {severity}.
        slots:
          id: path.id
          severity: requestBody.severity
      - text: Update the rule of policy {id} to {rule}.
        slots:
          id: path.id
          rule: requestBody.rule
      method: generated
      generated: '2026-09-26'
- target: $.paths['/policy/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a policy
      effect: destructive
      questions:
      - How do I permanently remove a custom policy?
      - What happens to a policy's alerts after it's deleted?
      instructions:
      - text: Delete policy {id}.
        slots:
          id: path.id
      - text: Remove custom policy {id} from Prisma Cloud.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/policy/{id}/status/{enabled}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable a policy
      effect: write
      questions:
      - Can I switch a policy off without deleting it?
      - How do I turn a disabled policy back on?
      instructions:
      - text: Set policy {id} enabled status to {enabled}.
        slots:
          id: path.id
          enabled: path.enabled
      - text: Disable policy {id} by setting enabled to {enabled}.
        slots:
          id: path.id
          enabled: path.enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/policy/compliance'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported compliance standards
      effect: read
      questions:
      - Which compliance standards does Prisma Cloud support for policies?
      - What sections does each supported compliance standard have?
      instructions:
      - text: List all compliance standards available for policies with their sections.
      - text: Show me the policy compliance standards catalog.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/policy/rule/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Pre-validate a policy rule without saving
      effect: read
      questions:
      - Can I check whether a policy rule is valid before creating the policy?
      - Which policy types can be dry-run validated?
      instructions:
      - text: Validate rule {rule} for a {policyType} policy named {name} without creating it.
        slots:
          rule: requestBody.rule
          policyType: requestBody.policyType
          name: requestBody.name
      - text: Dry-run check policy rule {rule} before I save it.
        slots:
          rule: requestBody.rule
      method: generated
      generated: '2026-09-26'