# 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 Red Teaming - Network Channel Channels API
  version: 1.0.0
extends: openapi/palo-alto-networks-channels-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: 5
- target: $.paths['/v1/channels'].get
  update:
    x-apievangelist-phrasing:
      intent: List red teaming network channels
      effect: read
      questions:
      - Which network channels are set up for AI red teaming?
      - Can I filter channels by status or search them by name?
      instructions:
      - text: List channels with status {status}.
        slots:
          status: query.status
      - text: Search network channels for {search}.
        slots:
          search: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/channels'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a network channel
      effect: write
      questions:
      - How do I add a new network channel for red teaming scans?
      - Can I give a new channel a description?
      instructions:
      - text: Create a network channel named {name}.
        slots:
          name: requestBody.name
      - text: Add channel {name} described as {description}.
        slots:
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/channels/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get network channel statistics
      effect: read
      questions:
      - How many network channels do I have and in what states?
      - Are there aggregate stats for my red teaming channels?
      instructions:
      - text: Show network channel statistics.
      - text: Get stats across all my channels.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/channels/{channelId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a network channel
      effect: read
      questions:
      - How do I look up one network channel's details?
      - What is configured on a particular channel?
      instructions:
      - text: Get channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Show the details of network channel {channelId}.
        slots:
          channelId: path.channelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/channels/{channelId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename or redescribe a network channel
      effect: write
      questions:
      - Can I rename an existing network channel?
      - How do I change a channel's description?
      instructions:
      - text: Rename channel {channelId} to {name}.
        slots:
          channelId: path.channelId
          name: requestBody.name
      - text: Set the description of channel {channelId} to {description}.
        slots:
          channelId: path.channelId
          description: requestBody.description
      method: generated
      generated: '2026-09-26'