# 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 App API
  version: 1.0.0
extends: openapi/cohesity-app-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/apps'].get
  update:
    x-apievangelist-phrasing:
      intent: List available and installed apps
      effect: read
      questions:
      - Which marketplace apps are installed or available to install on my cluster?
      - What metadata is shown for each cluster app?
      instructions:
      - text: List apps on the cluster.
      - text: Show apps available to install.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/apps'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload and install an app from an image
      effect: write
      questions:
      - Can I install an app by uploading its image file?
      - How do I side-load a cluster app package?
      instructions:
      - text: Upload this app image and install it.
      - text: Install an app from an uploaded image file.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/apps/{appUid}/versions/{version}'].post
  update:
    x-apievangelist-phrasing:
      intent: Install a purchased app version
      effect: write
      questions:
      - Can I install a specific version of a purchased app on the cluster?
      - Which apps can be installed, only purchased ones?
      instructions:
      - text: Install app {appUid} version {version}.
        slots:
          appUid: path.appUid
          version: path.version
      - text: Start installing version {version} of app {appUid} on the cluster.
        slots:
          version: path.version
          appUid: path.appUid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/apps/{appUid}/versions/{version}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Uninstall an app version
      effect: destructive
      questions:
      - Can I uninstall an app version from the cluster?
      - What needs to be true before an app can be uninstalled?
      instructions:
      - text: Uninstall app {appUid} version {version}.
        slots:
          appUid: path.appUid
          version: path.version
      - text: Remove version {version} of app {appUid} from the cluster.
        slots:
          version: path.version
          appUid: path.appUid
      method: generated
      generated: '2026-10-01'