# 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 Enforcement Recommendation APIs API
  version: 1.0.0
extends: openapi/harness-governance-enforcement-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: 6
- target: $.paths['/ccm/api/governance/enforcementRecommendation/accept'].put
  update:
    x-apievangelist-phrasing:
      intent: Accept governance enforcement recommendations
      effect: write
      questions:
      - How do I accept suggested governance rule enforcements for my cloud accounts?
      - Can I accept several enforcement recommendations at once?
      instructions:
      - text: Accept enforcement recommendations {ids}.
        slots:
          ids: query.enforcementRecommendationIds
      - text: Approve governance enforcement recommendations {ids} for account {account}.
        slots:
          ids: query.enforcementRecommendationIds
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/enforcementRecommendation/dismiss'].put
  update:
    x-apievangelist-phrasing:
      intent: Dismiss governance enforcement recommendations
      effect: write
      questions:
      - How do I dismiss governance enforcement suggestions I don't want?
      - Can I reject a batch of enforcement recommendations?
      instructions:
      - text: Dismiss enforcement recommendations {ids}.
        slots:
          ids: query.enforcementRecommendationIds
      - text: Reject governance enforcement suggestions {ids} in account {account}.
        slots:
          ids: query.enforcementRecommendationIds
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/enforcementRecommendation/details'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an enforcement recommendation's details
      effect: read
      questions:
      - What rules, accounts and schedule does a governance enforcement recommendation propose?
      - Can I look at one enforcement recommendation before accepting it?
      instructions:
      - text: Get details of enforcement recommendation {id}.
        slots:
          id: query.enforcementRecommendationId
      - text: Show what enforcement recommendation {id} would enforce.
        slots:
          id: query.enforcementRecommendationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/enforcementRecommendation/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List enforcement recommendations by search key
      effect: read
      questions:
      - Which governance enforcement recommendations are open for my account?
      - Can I search enforcement recommendations with a simple keyword via query parameters?
      instructions:
      - text: List governance enforcement recommendations matching {key} using the GET list.
        slots:
          key: query.searchKey
      - text: Show enforcement recommendations for account {account}, page {page}.
        slots:
          account: query.accountIdentifier
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/enforcementRecommendation/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Filter enforcement recommendations by rules and targets
      effect: read
      questions:
      - Can I filter enforcement recommendations by rule IDs, target accounts and regions?
      - Which enforcement recommendations are dry-run versus enabled for certain regions?
      instructions:
      - text: List enforcement recommendations for rules {rules} in regions {regions}.
        slots:
          rules: requestBody.ruleIds
          regions: requestBody.targetRegions
      - text: Filter enforcement recommendations targeting accounts {accounts} that are dry run {dry_run}.
        slots:
          accounts: requestBody.targetAccounts
          dry_run: requestBody.isDryRun
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/enforcementRecommendation/update'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an enforcement recommendation
      effect: write
      questions:
      - How do I adjust the schedule or target regions of an enforcement recommendation?
      - Can I switch an enforcement recommendation to dry run before accepting it?
      instructions:
      - text: Update enforcement recommendation {uuid} to run on schedule {schedule}.
        slots:
          uuid: requestBody.uuid
          schedule: requestBody.executionSchedule
      - text: Set enforcement recommendation {uuid} target regions to {regions} in account {account}.
        slots:
          uuid: requestBody.uuid
          regions: requestBody.targetRegions
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'