# 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 Node Groups API
  version: 1.0.0
extends: openapi/cohesity-node-groups-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: 5
- target: $.paths['/nodeGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List node groups
      effect: read
      questions:
      - What node groups are configured on the cluster?
      - Can I filter node groups by type?
      instructions:
      - text: List node groups named {groupNames}.
        slots:
          groupNames: query.groupNames
      - text: Show node groups of type {groupType}.
        slots:
          groupType: query.groupType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nodeGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a node group
      effect: write
      questions:
      - How do I group a set of nodes together with their own subnet and DNS settings?
      - Can I create a node group with a BGP instance?
      instructions:
      - text: Create node group {name}.
        slots:
          name: requestBody.name
      - text: Create node group {name} containing nodes {node-ids}.
        slots:
          name: requestBody.name
          node-ids: requestBody.node-ids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nodeGroups/{groupName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a node group by name
      effect: read
      questions:
      - How do I look up one node group and the nodes in it?
      - Which nodes belong to a named node group?
      instructions:
      - text: Get node group {groupName}.
        slots:
          groupName: path.groupName
      - text: Show the nodes in group {groupName}.
        slots:
          groupName: path.groupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nodeGroups/{groupName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a node group
      effect: write
      questions:
      - Can I add or remove nodes from an existing node group?
      - How do I change a node group's DNS servers?
      instructions:
      - text: Update node group {groupName} to name {name}.
        slots:
          groupName: path.groupName
          name: requestBody.name
      - text: Set the members of node group {groupName} ({name}) to nodes {node-ids}.
        slots:
          groupName: path.groupName
          name: requestBody.name
          node-ids: requestBody.node-ids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nodeGroups/{groupName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a node group
      effect: destructive
      questions:
      - How do I remove a node group I no longer use?
      - Can I delete a node group by its name?
      instructions:
      - text: Delete node group {groupName}.
        slots:
          groupName: path.groupName
      - text: Remove the {groupName} node group.
        slots:
          groupName: path.groupName
      method: generated
      generated: '2026-10-01'