# 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 Overview API
  version: 1.0.0
extends: openapi/harness-governance-overview-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: 6
- target: $.paths['/ccm/api/governance/overview/dayWiseTotalEvaluations'].post
  update:
    x-apievangelist-phrasing:
      intent: Chart daily governance evaluations by status
      effect: read
      questions:
      - How many cloud governance evaluations ran each day, broken down by status?
      - Can I see the daily evaluation trend just for one cloud provider?
      instructions:
      - text: Show day-by-day governance evaluations by status for account {account}.
        slots:
          account: query.accountIdentifier
      - text: Break down daily evaluations by status for cloud provider {cloud}.
        slots:
          cloud: query.cloudProvider
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/overview/totalNewEnforcementRecommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: Count new enforcement recommendations
      effect: read
      questions:
      - How many new governance enforcement recommendations are waiting for us?
      - Are there new enforcement recommendations for our cloud accounts?
      instructions:
      - text: Count new enforcement recommendations in account {account}.
        slots:
          account: query.accountIdentifier
      - text: Tally the new enforcement recommendations for cloud provider {cloud}.
        slots:
          cloud: query.cloudProvider
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/overview/totalActiveEnforcements'].get
  update:
    x-apievangelist-phrasing:
      intent: Count active governance enforcements
      effect: read
      questions:
      - How many governance enforcements are currently active?
      - What is the number of active enforcements per cloud provider?
      instructions:
      - text: Count the active enforcements in account {account}.
        slots:
          account: query.accountIdentifier
      - text: Give me the active enforcement total for cloud provider {cloud}.
        slots:
          cloud: query.cloudProvider
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/overview/totalEvaluations'].get
  update:
    x-apievangelist-phrasing:
      intent: Count total governance evaluations
      effect: read
      questions:
      - What is the overall number of governance rule evaluations to date?
      - How many evaluations have run against one cloud provider in total?
      instructions:
      - text: Get the total number of governance evaluations for account {account}.
        slots:
          account: query.accountIdentifier
      - text: Return the all-time evaluation count for {cloud}.
        slots:
          cloud: query.cloudProvider
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/overview/totalRealisedSavingsV2'].post
  update:
    x-apievangelist-phrasing:
      intent: Get total realised governance savings
      effect: read
      questions:
      - How much money has cloud asset governance saved us overall?
      - What is the total realised savings figure for one cloud provider?
      instructions:
      - text: Show the total realised governance savings for account {account}.
        slots:
          account: query.accountIdentifier
      - text: Get the single total savings figure realised on {cloud}.
        slots:
          cloud: query.cloudProvider
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/overview/totalRealisedSavingsGrouped'].get
  update:
    x-apievangelist-phrasing:
      intent: Break down realised savings by cloud or resource type
      effect: read
      questions:
      - Which resource types contributed most to our governance savings?
      - Can I see realised savings split out per cloud provider?
      instructions:
      - text: Break down realised savings by cloud provider and resource type for account {account}.
        slots:
          account: query.accountIdentifier
      - text: Group governance savings by resource type for {cloud}.
        slots:
          cloud: query.cloudProvider
      method: generated
      generated: '2026-09-26'