# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity Services RADIUS Server Profiles API
  version: 1.0.0
extends: openapi/palo-alto-networks-radius-server-profiles-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['/radius-server-profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List RADIUS server profiles
      effect: read
      questions:
      - Which RADIUS server profiles are configured for authentication?
      - Can I look up RADIUS profiles in one folder?
      instructions:
      - text: List RADIUS server profiles in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the RADIUS profile named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/radius-server-profiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a RADIUS server profile
      effect: write
      questions:
      - How do I add a RADIUS server for user authentication?
      - Can I set retries and timeout on a new RADIUS profile?
      instructions:
      - text: Create RADIUS profile {name} using protocol {protocol} with servers {server}.
        slots:
          name: requestBody.name
          protocol: requestBody.protocol
          server: requestBody.server
      - text: Add a RADIUS server profile {name}, protocol {protocol}, servers {server}, timeout {timeout}.
        slots:
          name: requestBody.name
          protocol: requestBody.protocol
          server: requestBody.server
          timeout: requestBody.timeout
      method: generated
      generated: '2026-09-26'
- target: $.paths['/radius-server-profiles/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a RADIUS server profile
      effect: read
      questions:
      - What servers and protocol does a RADIUS profile use?
      - Can I retrieve one RADIUS profile by ID?
      instructions:
      - text: Show RADIUS server profile {id}.
        slots:
          id: path.id
      - text: Get the settings of RADIUS profile {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/radius-server-profiles/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a RADIUS server profile
      effect: write
      questions:
      - Can I change the authentication protocol on an existing RADIUS profile?
      - How do I raise the retry count of a RADIUS profile I already have?
      instructions:
      - text: Update RADIUS profile {id} ({name}) to protocol {protocol} with servers {server}.
        slots:
          id: path.id
          name: requestBody.name
          protocol: requestBody.protocol
          server: requestBody.server
      - text: Set retries to {retries} on existing RADIUS profile {id}, name {name}, protocol {protocol}, servers {server}.
        slots:
          retries: requestBody.retries
          id: path.id
          name: requestBody.name
          protocol: requestBody.protocol
          server: requestBody.server
      method: generated
      generated: '2026-09-26'
- target: $.paths['/radius-server-profiles/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a RADIUS server profile
      effect: destructive
      questions:
      - Can I delete a RADIUS server profile?
      - What removes an old RADIUS authentication profile?
      instructions:
      - text: Delete RADIUS server profile {id}.
        slots:
          id: path.id
      - text: Remove the RADIUS profile {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/config/v1/radius-server-profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List RADIUS server profiles
      effect: read
      questions:
      - Which RADIUS server profiles are configured?
      - Can I find a RADIUS profile by name in a folder?
      instructions:
      - text: List RADIUS server profiles in folder {folder}, snippet {snippet}, device {device}.
        slots:
          folder: query.folder
          snippet: query.snippet
          device: query.device
      - text: Find RADIUS profile {name} in {folder}/{snippet} on {device}.
        slots:
          name: query.name
          folder: query.folder
          snippet: query.snippet
          device: query.device
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/radius-server-profiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a RADIUS server profile
      effect: write
      questions:
      - How do I add RADIUS servers to a folder, snippet or device?
      - Can I set timeout and retries when creating a RADIUS profile in a snippet?
      instructions:
      - text: Create a RADIUS profile with servers {server} in {folder}, snippet {snippet}, device {device}.
        slots:
          server: requestBody.server
          folder: query.folder
          snippet: query.snippet
          device: query.device
      - text: Add RADIUS servers {server} using protocol {protocol} to {folder}/{snippet} on {device}.
        slots:
          server: requestBody.server
          protocol: requestBody.protocol
          folder: query.folder
          snippet: query.snippet
          device: query.device
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/radius-server-profiles/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a RADIUS server profile
      effect: read
      questions:
      - How do I view one RADIUS server profile?
      - Via the SSE config v1 path, which servers and protocol does a RADIUS profile use?
      instructions:
      - text: Get RADIUS server profile {id}.
        slots:
          id: path.id
      - text: Show RADIUS profile {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/radius-server-profiles/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a RADIUS server profile
      effect: write
      questions:
      - Can I change the servers listed in a RADIUS profile?
      - How do I raise the timeout on an existing RADIUS profile?
      instructions:
      - text: Update RADIUS profile {id} to use servers {server}.
        slots:
          id: path.id
          server: requestBody.server
      - text: Set RADIUS profile {id} timeout to {timeout} with servers {server}.
        slots:
          id: path.id
          timeout: requestBody.timeout
          server: requestBody.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/radius-server-profiles/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a RADIUS server profile
      effect: destructive
      questions:
      - How do I delete a RADIUS server profile?
      - Can I remove a RADIUS profile we stopped using?
      instructions:
      - text: Delete RADIUS server profile {id} using the SSE config v1 endpoint.
        slots:
          id: path.id
      - text: Remove RADIUS profile {id} permanently.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'