# 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 TACACS Server Profiles API
  version: 1.0.0
extends: openapi/palo-alto-networks-tacacs-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['/tacacs-server-profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List TACACS+ server profiles
      effect: read
      questions:
      - Which TACACS+ server profiles are configured for admin authentication?
      - Can I list TACACS+ profiles defined in a specific folder?
      instructions:
      - text: List TACACS+ server profiles in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the TACACS+ server profile named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tacacs-server-profiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a TACACS+ server profile
      effect: write
      questions:
      - How do I add a TACACS+ server profile with a chosen authentication protocol?
      - Can I make a TACACS+ profile use a single connection and a custom timeout?
      instructions:
      - text: Create TACACS+ profile {name} (id {id}) using protocol {protocol} and servers {server}.
        slots:
          name: requestBody.name
          id: requestBody.id
          protocol: requestBody.protocol
          server: requestBody.server
      - text: Add TACACS+ profile {name} with id {id}, protocol {protocol}, servers {server} and a {timeout}-second timeout.
        slots:
          name: requestBody.name
          id: requestBody.id
          protocol: requestBody.protocol
          server: requestBody.server
          timeout: requestBody.timeout
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tacacs-server-profiles/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a TACACS+ server profile
      effect: read
      questions:
      - What servers and protocol does a particular TACACS+ profile use?
      - Can I fetch a TACACS+ server profile by UUID?
      instructions:
      - text: Get TACACS+ server profile {id}.
        slots:
          id: path.id
      - text: Show the servers configured in TACACS+ profile {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tacacs-server-profiles/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a TACACS+ server profile
      effect: write
      questions:
      - How do I change the servers listed in an existing TACACS+ profile?
      - Can I switch the authentication protocol on a TACACS+ profile I already have?
      instructions:
      - text: 'Update TACACS+ profile {id}: name {name}, protocol {protocol}, servers {server}.'
        slots:
          id: path.id
          name: requestBody.name
          protocol: requestBody.protocol
          server: requestBody.server
      - text: Switch TACACS+ profile {id} ({name}, servers {server}) to protocol {protocol}.
        slots:
          id: path.id
          name: requestBody.name
          server: requestBody.server
          protocol: requestBody.protocol
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tacacs-server-profiles/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a TACACS+ server profile
      effect: destructive
      questions:
      - How do I remove a TACACS+ server profile?
      - Can I delete a TACACS+ profile by its UUID?
      instructions:
      - text: Delete TACACS+ server profile {id}.
        slots:
          id: path.id
      - text: Remove the TACACS+ profile with UUID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/config/v1/tacacs-server-profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List TACACS+ server profiles
      effect: read
      questions:
      - Which TACACS+ server profiles does the SSE config v1 endpoint list for a folder, snippet or device?
      - Can I look up a TACACS server profile by name?
      instructions:
      - text: List TACACS server profiles in folder {folder}, snippet {snippet}, device {device}.
        slots:
          folder: query.folder
          snippet: query.snippet
          device: query.device
      - text: Find TACACS profile {name} in folder {folder}, snippet {snippet}, device {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/tacacs-server-profiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a TACACS+ server profile
      effect: write
      questions:
      - How do I add a TACACS+ server for administrator authentication?
      - Can I make a TACACS server profile use a single connection for all sessions?
      instructions:
      - text: Create a TACACS profile with servers {server} over {protocol} in folder {folder}, snippet {snippet}, device {device}.
        slots:
          server: requestBody.server
          protocol: requestBody.protocol
          folder: query.folder
          snippet: query.snippet
          device: query.device
      - text: Add TACACS servers {server} using {protocol} with timeout {timeout} to folder {folder}, snippet {snippet}, device {device}.
        slots:
          server: requestBody.server
          protocol: requestBody.protocol
          timeout: requestBody.timeout
          folder: query.folder
          snippet: query.snippet
          device: query.device
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/tacacs-server-profiles/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a TACACS+ server profile
      effect: read
      questions:
      - Can I read one TACACS server profile through the SSE config v1 API?
      - Can I fetch one TACACS server profile by id?
      instructions:
      - text: Show TACACS server profile {id}.
        slots:
          id: path.id
      - text: Get the server list of TACACS profile {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/tacacs-server-profiles/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a TACACS+ server profile
      effect: write
      questions:
      - How do I edit a TACACS server profile through the SSE config v1 endpoint?
      - Can I raise the timeout on a TACACS server profile already set up?
      instructions:
      - text: Edit TACACS profile {id} to servers {server} using {protocol}.
        slots:
          id: path.id
          server: requestBody.server
          protocol: requestBody.protocol
      - text: Set timeout {timeout} on existing TACACS profile {id} with servers {server} and protocol {protocol}.
        slots:
          timeout: requestBody.timeout
          id: path.id
          server: requestBody.server
          protocol: requestBody.protocol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/tacacs-server-profiles/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a TACACS+ server profile
      effect: destructive
      questions:
      - How do I delete a TACACS server profile?
      - Can I remove a TACACS profile we retired?
      instructions:
      - text: Delete SSE config TACACS server profile {id}.
        slots:
          id: path.id
      - text: Remove the retired TACACS profile {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'