# 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 Nodes API
  version: 1.0.0
extends: openapi/cohesity-nodes-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['/public/freeNodes'].get
  update:
    x-apievangelist-phrasing:
      intent: List free nodes on the network
      effect: read
      questions:
      - Which unclustered Cohesity nodes are available on the network to add?
      - Can I discover free nodes before expanding a cluster?
      instructions:
      - text: List free nodes on the network.
      - text: Show nodes available to join a cluster.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/node/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the status of a node
      effect: read
      questions:
      - Is the node I'm talking to healthy and what state is it in?
      - Can I check one node's status directly?
      instructions:
      - text: Get this node's status.
      - text: Check the status of the node I'm connected to.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/nodes'].get
  update:
    x-apievangelist-phrasing:
      intent: List cluster nodes
      effect: read
      questions:
      - Which nodes make up my Cohesity cluster?
      - What nodes are currently in the cluster?
      instructions:
      - text: List the nodes in the cluster.
      - text: Show every node in my cluster.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/nodes/software'].put
  update:
    x-apievangelist-phrasing:
      intent: Upgrade node software
      effect: write
      questions:
      - Can I upgrade a node to a specific software version?
      - Is it possible to upgrade all free nodes at once?
      instructions:
      - text: Upgrade nodes {nodeIds} to version {targetSwVersion}.
        slots:
          nodeIds: requestBody.nodeIds
          targetSwVersion: requestBody.targetSwVersion
      - text: Upgrade all free nodes to {targetSwVersion}.
        slots:
          targetSwVersion: requestBody.targetSwVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/nodes/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one node's details
      effect: read
      questions:
      - What are the details of a specific node in the cluster?
      - Can I look up a node by its id?
      instructions:
      - text: Get node {id}.
        slots:
          id: path.id
      - text: Show details of node {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'