# 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 Certificates API
  version: 1.0.0
extends: openapi/cohesity-certificates-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/certificates/global'].get
  update:
    x-apievangelist-phrasing:
      intent: List host certificates generated by the cluster
      effect: read
      questions:
      - Which certificates has the cluster generated and deployed to hosts?
      - Can I see the details of all host certificates issued from this cluster?
      instructions:
      - text: List the host certificates generated by the cluster.
      - text: Show all deployed global host certificates.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/certificates/global'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate and deploy host certificates
      effect: write
      questions:
      - Can I generate a certificate and push it to one or more hosts?
      - How long can a generated host certificate stay valid?
      instructions:
      - text: Generate and deploy a certificate to hosts {hostsInfoList}.
        slots:
          hostsInfoList: requestBody.hostsInfoList
      - text: Deploy a host certificate valid for {validDays} days to {hostsInfoList}.
        slots:
          validDays: requestBody.validDays
          hostsInfoList: requestBody.hostsInfoList
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/certificates/webServer'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the cluster web server certificate
      effect: read
      questions:
      - Which SSL certificate is the cluster's web server using right now?
      - When was the web server certificate last updated?
      instructions:
      - text: Show the cluster web server certificate.
      - text: Get the SSL certificate configured for the cluster UI.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/certificates/webServer'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the cluster web server certificate
      effect: write
      questions:
      - How do I install my own SSL certificate on the cluster web server?
      - What does replacing the web server certificate need, a cert and private key?
      instructions:
      - text: Install web server certificate {certificate} with private key {privateKey}.
        slots:
          certificate: requestBody.certificate
          privateKey: requestBody.privateKey
      - text: Replace the cluster SSL certificate with {certificate}.
        slots:
          certificate: requestBody.certificate
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/certificates/webServer'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the cluster web server certificate
      effect: destructive
      questions:
      - Can I remove the custom SSL certificate from the cluster?
      - What happens to the web server certificate if I delete it?
      instructions:
      - text: Delete the cluster web server certificate.
      - text: Remove the custom SSL certificate from the cluster.
      method: generated
      generated: '2026-10-01'