API Evangelist conversational phrasing for Objects Application Filters API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Objects Application Filters API
  version: 1.0.0
extends: openapi/palo-alto-networks-application-filters-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/application-filters'].get
  update:
    x-apievangelist-phrasing:
      intent: List application filters
      effect: read
      questions:
      - What application filters are defined in Strata Cloud Manager?
      - Can I list application filters for one folder, snippet or device?
      instructions:
      - text: List application filters in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the application filter named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-filters'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an application filter
      effect: write
      questions:
      - How do I build a filter that matches all apps known to be used by malware?
      - Can an application filter match by category, risk level or SaaS certifications?
      instructions:
      - text: Create application filter {name} for category {category}.
        slots:
          name: requestBody.name
          category: requestBody.category
      - text: Create application filter {name} matching apps with risk {risk}.
        slots:
          name: requestBody.name
          risk: requestBody.risk
      - text: Make filter {name} that catches apps that tunnel other apps.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-filters/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application filter
      effect: read
      questions:
      - Where can I see the criteria of one application filter?
      - Which categories and risk levels does a given application filter match?
      instructions:
      - text: Get application filter {id}.
        slots:
          id: path.id
      - text: Show the matching criteria of application filter {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-filters/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an application filter
      effect: write
      questions:
      - How do I add a subcategory to an existing application filter?
      - Can I exclude specific apps from an application filter I already made?
      instructions:
      - text: Update application filter {id} named {name} to subcategory {subcategory}.
        slots:
          id: path.id
          name: requestBody.name
          subcategory: requestBody.subcategory
      - text: Exclude apps {exclude} from application filter {id}.
        slots:
          exclude: requestBody.exclude
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-filters/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application filter
      effect: destructive
      questions:
      - Can I remove an application filter from Strata Cloud Manager?
      - What happens to policies when I delete an application filter?
      instructions:
      - text: Delete application filter {id}.
        slots:
          id: path.id
      - text: Remove the application filter with UUID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/config/v1/application-filters'].get
  update:
    x-apievangelist-phrasing:
      intent: List application filters in a folder
      effect: read
      questions:
      - What application filters are configured in my Prisma Access folder?
      - Can I search application filters by name?
      instructions:
      - text: List the SSE config application filters in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the application filter named {name} in folder {folder}.
        slots:
          name: query.name
          folder: query.folder
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/application-filters'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an application filter
      effect: write
      questions:
      - How do I create a filter that matches risky or evasive applications?
      - Can a new application filter target apps used by malware or with known vulnerabilities?
      instructions:
      - text: Create application filter {name} in folder {folder}.
        slots:
          name: requestBody.name
          folder: query.folder
      - text: Create filter {name} in {folder} matching category {category} and risk {risk}.
        slots:
          name: requestBody.name
          folder: query.folder
          category: requestBody.category
          risk: requestBody.risk
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/application-filters/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application filter
      effect: read
      questions:
      - Can I read one application filter through the SSE config v1 endpoint?
      - Which characteristics does a specific application filter match on?
      instructions:
      - text: Fetch SSE config application filter {id}.
        slots:
          id: path.id
      - text: Show the match criteria of application filter {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/application-filters/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an application filter
      effect: write
      questions:
      - Can I change the categories or risk levels an existing application filter matches?
      - Is it possible to make an existing filter exclude certain apps?
      instructions:
      - text: Edit SSE v1 application filter {id} ({name}) so it only matches subcategory {subcategory}.
        slots:
          id: path.id
          name: requestBody.name
          subcategory: requestBody.subcategory
      - text: Edit filter {id} ({name}) to exclude {exclude}.
        slots:
          id: path.id
          name: requestBody.name
          exclude: requestBody.exclude
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/application-filters/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application filter
      effect: destructive
      questions:
      - How do I remove an application filter?
      - Can I delete an application filter by ID?
      instructions:
      - text: Delete SSE config application filter {id}.
        slots:
          id: path.id
      - text: Remove the application filter with ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'