# 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 Cluster API
  version: 1.0.0
extends: openapi/cohesity-cluster-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: 6
- target: $.paths['/public/basicClusterInfo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get basic cluster info without logging in
      effect: read
      questions:
      - What version and domains does a Cohesity cluster have, before I authenticate?
      - Can I see which Active Directory domains a cluster has joined?
      instructions:
      - text: Get the basic cluster info, including name, version and domains.
      - text: Show the joined login domains for this cluster without authentication.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/cluster'].get
  update:
    x-apievangelist-phrasing:
      intent: Get cluster configuration
      effect: read
      questions:
      - What is the full configuration of this Cohesity cluster?
      - Can I include usage stats when fetching cluster details?
      instructions:
      - text: Show this cluster's configuration.
      - text: Get the cluster details with stats set to {fetchStats}.
        slots:
          fetchStats: query.fetchStats
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/cluster'].put
  update:
    x-apievangelist-phrasing:
      intent: Update cluster configuration
      effect: write
      questions:
      - How do I change the cluster's DNS servers or timezone?
      - Can I enable multi-tenancy on the cluster?
      instructions:
      - text: Set the cluster timezone to {timezone}.
        slots:
          timezone: requestBody.timezone
      - text: Update the cluster DNS servers to {dnsServerIps}.
        slots:
          dnsServerIps: requestBody.dnsServerIps
      - text: Rename the cluster to {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/cluster/appSettings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get cluster app settings
      effect: read
      questions:
      - How much CPU and memory is reserved for apps on the cluster?
      - What apps mode and subnet are configured?
      instructions:
      - text: Show the cluster app settings.
      - text: Get the reserved CPU and memory for apps on this cluster.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/cluster/appSettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update cluster app settings
      effect: write
      questions:
      - Can I reserve more memory for apps running on the cluster?
      - How do I allow external traffic to cluster apps?
      instructions:
      - text: Reserve {reservedMemoryPct} percent of memory for apps.
        slots:
          reservedMemoryPct: requestBody.reservedMemoryPct
      - text: Set apps mode to {appsMode} on the cluster.
        slots:
          appsMode: requestBody.appsMode
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/cluster/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Get node status for the cluster
      effect: read
      questions:
      - Are all the nodes in my cluster healthy?
      - What's the current status of each cluster node?
      instructions:
      - text: Show the status of every node in the cluster.
      - text: Check the cluster status.
      method: generated
      generated: '2026-10-01'