# 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 Patches API
  version: 1.0.0
extends: openapi/cohesity-patches-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: 7
- target: $.paths['/patch-management/applied-patches'].get
  update:
    x-apievangelist-phrasing:
      intent: List patches currently applied
      effect: read
      questions:
      - Which patches are running on my cluster right now?
      - Can I see the individual fixes included in an applied patch for one service?
      instructions:
      - text: List the patches applied on the cluster.
      - text: Show the applied patch and its fixes for service {service}.
        slots:
          service: query.service
      method: generated
      generated: '2026-10-01'
- target: $.paths['/patch-management/applied-patches'].post
  update:
    x-apievangelist-phrasing:
      intent: Revert an applied patch
      effect: destructive
      questions:
      - How do I roll back a patch that caused problems?
      - Can I revert a service's patches down to a specific patch level?
      instructions:
      - text: Revert the patch on service {service}.
        slots:
          service: requestBody.service
      - text: Roll back {service} patches to level {patchLevel}.
        slots:
          service: requestBody.service
          patchLevel: requestBody.patchLevel
      method: generated
      generated: '2026-10-01'
- target: $.paths['/patch-management/available-patches'].get
  update:
    x-apievangelist-phrasing:
      intent: List patches ready to apply
      effect: read
      questions:
      - What patches have been imported and are ready to install?
      - Is there an available hotfix for a particular service?
      instructions:
      - text: List patches available to apply.
      - text: Show available patches for {service} with fix descriptions.
        slots:
          service: query.service
      method: generated
      generated: '2026-10-01'
- target: $.paths['/patch-management/available-patches'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a patch or hotfix
      effect: write
      questions:
      - How do I upload a hotfix file to the cluster?
      - Does importing a patch require a checksum?
      instructions:
      - text: Import patch file {fileName} with checksum {checksum}.
        slots:
          fileName: requestBody.fileName
          checksum: requestBody.checksum
      - text: Upload hotfix {patch} named {fileName} with checksum {checksum}.
        slots:
          patch: requestBody.patch
          fileName: requestBody.fileName
          checksum: requestBody.checksum
      method: generated
      generated: '2026-10-01'
- target: $.paths['/patch-management/available-patches'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply available patches
      effect: write
      questions:
      - How do I install the patch for one service along with its dependencies?
      - Can I apply every available patch at once?
      instructions:
      - text: Apply the available patch for service {service}.
        slots:
          service: requestBody.service
      - text: Apply all available patches to the cluster.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/patch-management/operation-status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check patch operation progress
      effect: read
      questions:
      - Is a patch install still running, and did the last one succeed?
      - Can I see per-node progress of the current patch operation?
      instructions:
      - text: Show the status of the current patch operation.
      - text: Get detailed per-node status of the last patch operation.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/patch-management/patches-history'].get
  update:
    x-apievangelist-phrasing:
      intent: View patch management history
      effect: read
      questions:
      - What patches have been applied or reverted on the cluster over time?
      - Can I see patch history for a single service?
      instructions:
      - text: Show the patch management history.
      - text: List past patch operations for service {service}.
        slots:
          service: query.service
      method: generated
      generated: '2026-10-01'