# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Kubex API – Kubernetes Clusters Results Kubernetes Cluster Results API
  version: 1.0.0
extends: openapi/densify-kubernetes-cluster-results-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: 2
- target: $.paths['/kubernetes/clusters/{clusterName}/containers'].get
  update:
    x-apievangelist-phrasing:
      intent: List base container recommendations for a cluster
      effect: read
      questions:
      - What are the base container manifest recommendations for my cluster?
      - Can I get container recommendations without uptime and OOM details?
      instructions:
      - text: List base container recommendations for cluster {clusterName}.
        slots:
          clusterName: path.clusterName
      - text: Show the standard container manifest recommendations in {clusterName}.
        slots:
          clusterName: path.clusterName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/kubernetes/clusters/{clusterName}/containers?details=true'].get
  update:
    x-apievangelist-phrasing:
      intent: List detailed container recommendations
      effect: read
      questions:
      - Which containers in my cluster had OOM kills in the last 7 days?
      - Can I see predicted uptime and audit dates alongside container recommendations?
      instructions:
      - text: List detailed container recommendations for cluster {clusterName} with details {details}.
        slots:
          clusterName: path.clusterName
          details: query.details
      - text: Show OOM kills and predicted uptime for containers in {clusterName}, details set to {details}.
        slots:
          clusterName: path.clusterName
          details: query.details
      method: generated
      generated: '2026-10-01'