# 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 Interface Group API
  version: 1.0.0
extends: openapi/cohesity-interface-group-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: 4
- target: $.paths['/public/interfaceGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List network interface groups
      effect: read
      questions:
      - Which network interface groups exist on the cluster?
      - What interfaces are bundled into each interface group?
      instructions:
      - text: List the cluster's interface groups.
      - text: Show all network interface groups.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/interfaceGroups'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a network interface group
      effect: write
      questions:
      - Can I change which interfaces belong to an existing interface group?
      - How do I modify an interface group's network parameters?
      instructions:
      - text: Update interface group {name} with interface lists {modelInterfaceLists}.
        slots:
          name: requestBody.name
          modelInterfaceLists: requestBody.modelInterfaceLists
      - text: Change network parameters of interface group {id}.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/interfaceGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a network interface group
      effect: write
      questions:
      - How do I create a new interface group for a product model's NICs?
      - Can I set network parameters when creating an interface group?
      instructions:
      - text: Create interface group {name}.
        slots:
          name: requestBody.name
      - text: Create interface group {name} with interfaces {modelInterfaceLists}.
        slots:
          name: requestBody.name
          modelInterfaceLists: requestBody.modelInterfaceLists
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/interfaceGroups/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a network interface group
      effect: destructive
      questions:
      - How do I remove an interface group I set up by mistake?
      - Can I delete an interface group by name?
      instructions:
      - text: Delete interface group {name}.
        slots:
          name: path.name
      - text: Remove the {name} interface group.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'