# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Governance Recommendation APIs API
  version: 1.0.0
extends: openapi/harness-governance-recommendation-apis-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/ccm/api/governance/recommendationHealth'].get
  update:
    x-apievangelist-phrasing:
      intent: Get recommendation health for a governance rule
      effect: read
      questions:
      - How healthy are the cost recommendations produced by one governance rule?
      - Is a particular cloud governance rule still generating recommendations successfully?
      instructions:
      - text: Show recommendation health for governance rule {ruleId}.
        slots:
          ruleId: query.ruleId
      - text: Get the health summary of rule {ruleId} in account {accountIdentifier}.
        slots:
          ruleId: query.ruleId
          accountIdentifier: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/recommendation/{recommendationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a governance recommendation
      effect: read
      questions:
      - What are the details of a specific cloud governance recommendation?
      - How do I open one recommendation by its id to see what it suggests?
      instructions:
      - text: Get governance recommendation {recommendationId}.
        slots:
          recommendationId: path.recommendationId
      - text: Show details of recommendation {recommendationId} for account {accountIdentifier}.
        slots:
          recommendationId: path.recommendationId
          accountIdentifier: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/recommendationHealth/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List recommendation health across governance rules
      effect: read
      questions:
      - Which governance rules have unhealthy recommendations right now?
      - Can I filter rule recommendation health by cloud provider or out-of-the-box rules?
      instructions:
      - text: List recommendation health for all governance rules in account {accountIdentifier}.
        slots:
          accountIdentifier: query.accountIdentifier
      - text: Show rule recommendation health for cloud {cloudProvider} with status {healthStatus}.
        slots:
          cloudProvider: requestBody.cloudProvider
          healthStatus: requestBody.healthStatus
      method: generated
      generated: '2026-09-26'