# 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 Alert API
  version: 1.0.0
extends: openapi/harness-governance-alert-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: 7
- target: $.paths['/ccm/api/governance/alert/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a governance alert rule
      effect: write
      questions:
      - Can I duplicate an existing cloud governance alert rule?
      - Is there a quick way to copy an alert rule as a starting point?
      instructions:
      - text: Clone governance alert rule {rule_id}.
        slots:
          rule_id: query.id
      - text: Copy alert rule {rule_id} in account {account}.
        slots:
          rule_id: query.id
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/alert'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a governance alert rule
      effect: write
      questions:
      - How do I change who gets emailed by a governance alert rule?
      - Can I change the cost threshold on an existing alert rule?
      instructions:
      - text: Update governance alert rule {rule_id} to email {emails}.
        slots:
          rule_id: query.id
          emails: requestBody.emailIds
      - text: Set the cost threshold of alert rule {rule_id} to {cost}.
        slots:
          rule_id: query.id
          cost: requestBody.cost
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/alert'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a governance alert rule
      effect: write
      questions:
      - What's needed to get emailed when cloud governance flags resources?
      - Can a new alert rule cover only certain cloud accounts and resource types?
      instructions:
      - text: Create a governance alert rule named {name} for cloud provider {cloud}.
        slots:
          name: requestBody.name
          cloud: requestBody.cloudProvider
      - text: Set up an alert rule {name} emailing {emails} for resource types {resource_types}.
        slots:
          name: requestBody.name
          emails: requestBody.emailIds
          resource_types: requestBody.resourceTypes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/alert/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a governance alert rule
      effect: destructive
      questions:
      - How do I permanently remove a governance alert rule?
      - Can I delete an alert rule by its id?
      instructions:
      - text: Delete governance alert rule {rule_id}.
        slots:
          rule_id: path.id
      - text: Remove alert rule {rule_id} from account {account}.
        slots:
          rule_id: path.id
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/alert/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List governance alert rules
      effect: read
      questions:
      - Which governance alert rules are set up in my account?
      - Can I see all cloud governance alerts at once?
      instructions:
      - text: List governance alert rules for account {account}.
        slots:
          account: query.accountIdentifier
      - text: Show all our governance alert rules.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/alert/resourceTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource types governance supports
      effect: read
      questions:
      - Which resource types can governance alerts watch for a given cloud?
      - What resource types does cloud governance support per cloud provider?
      instructions:
      - text: List governance resource types for cloud provider {cloud}.
        slots:
          cloud: query.cloudProvider
      - text: Show supported resource types for {cloud} in account {account}.
        slots:
          cloud: query.cloudProvider
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/governance/alert/toggle'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable a governance alert rule
      effect: write
      questions:
      - Can I pause a governance alert rule without deleting it?
      - Is there a switch to turn an alert rule back on?
      instructions:
      - text: Set governance alert rule {rule_id} enabled to {enable}.
        slots:
          rule_id: query.id
          enable: query.enableGovernanceAlertRule
      - text: Disable alert rule {rule_id}.
        slots:
          rule_id: query.id
      method: generated
      generated: '2026-09-26'