Palo Alto Networks · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Prisma AIRS API Management service Customer App API

5 actions 5 updates phrasing extends openapi/palo-alto-networks-customer-app-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Palo Alto Networks's API. It is a proposal applied on top of the contract, not a document Palo Alto Networks publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info

$.paths['/v1/mgmt/customerapp'].get

$.paths['/v1/mgmt/customerapp'].put

$.paths['/v1/mgmt/customerapp'].delete

$.paths['/v1/mgmt/customerapps'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma AIRS API Management service Customer App API
  version: 1.0.0
extends: openapi/palo-alto-networks-customer-app-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: 4
- target: $.paths['/v1/mgmt/customerapp'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an AI Runtime Security customer app
      effect: read
      questions:
      - Can I look up a registered customer app by its name?
      - Which cloud provider and model is a given customer app tied to?
      instructions:
      - text: Get customer app {app_name}.
        slots:
          app_name: query.app_name
      - text: Show the cloud, environment and AI model of app {app_name}.
        slots:
          app_name: query.app_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/mgmt/customerapp'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a customer app
      effect: write
      questions:
      - How do I change the AI model recorded for a customer app?
      - Can I update which agent framework a customer app uses?
      instructions:
      - text: Update customer app {customer_app_id} to name {app_name} on {cloud_provider} in environment {environment}.
        slots:
          customer_app_id: query.customer_app_id
          app_name: requestBody.app_name
          cloud_provider: requestBody.cloud_provider
          environment: requestBody.environment
      - text: Set model {model_name} on customer app {customer_app_id} named {app_name}.
        slots:
          customer_app_id: query.customer_app_id
          model_name: requestBody.model_name
          app_name: requestBody.app_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/mgmt/customerapp'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a customer app
      effect: destructive
      questions:
      - What's needed to remove a customer app from my tenant service group?
      - Why does deleting a customer app ask for the deleting user's email?
      instructions:
      - text: Delete customer app {app_name} as {updated_by}.
        slots:
          app_name: query.app_name
          updated_by: query.updated_by
      - text: Remove the app named {app_name}, recorded as deleted by {updated_by}.
        slots:
          app_name: query.app_name
          updated_by: query.updated_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/mgmt/customerapps'].get
  update:
    x-apievangelist-phrasing:
      intent: List all customer apps in my tenant
      effect: read
      questions:
      - Which customer apps are registered for my TSG?
      - Can I page through every customer app and its metadata?
      instructions:
      - text: List all customer apps.
      - text: List {limit} customer apps starting at offset {offset}.
        slots:
          limit: query.limit
          offset: query.offset
      method: generated
      generated: '2026-09-26'