# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cohesity REST Antivirus Service Group API
  version: 1.0.0
extends: openapi/cohesity-antivirusservicegroup-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: 9
- target: $.paths['/public/antivirusGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List antivirus service groups
      effect: read
      questions:
      - Which antivirus service groups are configured on my cluster?
      - Can I see the ICAP antivirus services in each group?
      instructions:
      - text: List the antivirus service groups.
      - text: Show all antivirus groups and their services.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/antivirusGroups'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an antivirus service group
      effect: write
      questions:
      - How do I add or change the antivirus services in a group?
      - Can I rename an existing antivirus group?
      instructions:
      - text: Update antivirus group {id} with name {name}.
        slots:
          id: requestBody.id
          name: requestBody.name
      - text: Set the antivirus services of group {id} named {name} to {antivirusServices}.
        slots:
          id: requestBody.id
          name: requestBody.name
          antivirusServices: requestBody.antivirusServices
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/antivirusGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an antivirus service group
      effect: write
      questions:
      - How do I set up antivirus scanning for my file views?
      - Can I group ICAP antivirus servers together?
      instructions:
      - text: Create an antivirus service group named {name}.
        slots:
          name: requestBody.name
      - text: Add antivirus group {name} with services {antivirusServices}.
        slots:
          name: requestBody.name
          antivirusServices: requestBody.antivirusServices
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/antivirusGroups/states'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable an antivirus group
      effect: write
      questions:
      - Can I turn off an antivirus service group temporarily?
      - How do I re-enable antivirus scanning for a group?
      instructions:
      - text: Set enabled to {enable} for antivirus group {id}.
        slots:
          enable: requestBody.enable
          id: requestBody.id
      - text: Toggle antivirus group {id} to enable={enable}.
        slots:
          id: requestBody.id
          enable: requestBody.enable
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/antivirusGroups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an antivirus service group
      effect: destructive
      questions:
      - How do I remove an antivirus service group?
      - Can I delete an antivirus group by id?
      instructions:
      - text: Delete antivirus service group {id}.
        slots:
          id: path.id
      - text: Remove antivirus group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/icapConnectionStatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Check ICAP server connectivity
      effect: read
      questions:
      - Are my ICAP antivirus servers reachable from the cluster?
      - Which ICAP connections are failing?
      instructions:
      - text: Check the connection status of ICAP servers {icapUris}.
        slots:
          icapUris: query.icapUris
      - text: Test ICAP connectivity for all configured servers.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/infectedFiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List infected files
      effect: read
      questions:
      - Which files did antivirus scanning flag as infected?
      - Can I see only quarantined infected files in a view?
      instructions:
      - text: List infected files in views {viewNames}.
        slots:
          viewNames: query.viewNames
      - text: Show infected files under path {filePath}, including quarantined ones.
        slots:
          filePath: query.filePath
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/infectedFiles'].put
  update:
    x-apievangelist-phrasing:
      intent: Change remediation state of infected files
      effect: write
      questions:
      - How do I quarantine or unquarantine infected files?
      - Can I mark infected files with a new remediation state?
      instructions:
      - text: Set remediation state {remediationState} on infected files {infectedFileIds}.
        slots:
          remediationState: requestBody.remediationState
          infectedFileIds: requestBody.infectedFileIds
      - text: Quarantine infected files {infectedFileIds} by setting remediation to {remediationState}.
        slots:
          infectedFileIds: requestBody.infectedFileIds
          remediationState: requestBody.remediationState
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/infectedFiles'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete infected files
      effect: destructive
      questions:
      - How do I permanently delete files flagged as infected?
      - Can I remove a list of infected files in one call?
      instructions:
      - text: Delete infected files {infectedFileIds}.
        slots:
          infectedFileIds: requestBody.infectedFileIds
      - text: Permanently remove the infected files {infectedFileIds}.
        slots:
          infectedFileIds: requestBody.infectedFileIds
      method: generated
      generated: '2026-10-01'