# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness AutoStopping Alerts API
  version: 1.0.0
extends: openapi/harness-autostopping-alerts-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: 5
- target: $.paths['/gateway/lw/api/accounts/{account_id}/alerts'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an AutoStopping alert
      effect: write
      questions:
      - How do I change who receives an existing AutoStopping alert?
      - Can I switch which events an AutoStopping alert fires on?
      instructions:
      - text: Update AutoStopping alert {id} named {name} for {entity_type} {entities} to notify {recipients} on {events}, account {account_id}, identifier {account}.
        slots:
          id: requestBody.id
          name: requestBody.name
          entity_type: requestBody.entity_type
          entities: requestBody.associated_entities
          recipients: requestBody.recipients
          events: requestBody.events
          account_id: path.account_id
          account: query.accountIdentifier
      - text: Change recipients of AutoStopping alert {id} to {recipients} in account {account_id}.
        slots:
          id: requestBody.id
          recipients: requestBody.recipients
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/alerts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an AutoStopping alert
      effect: write
      questions:
      - Can I get emailed or pinged in Slack when an AutoStopping warmup fails?
      - How do I set up notifications for AutoStopping rule lifecycle changes?
      instructions:
      - text: Create AutoStopping alert {name} for {entity_type} {entities} notifying {recipients} on {events} in account {account_id}.
        slots:
          name: requestBody.name
          entity_type: requestBody.entity_type
          entities: requestBody.associated_entities
          recipients: requestBody.recipients
          events: requestBody.events
          account_id: path.account_id
      - text: Alert {recipients} when cooldown fails on AutoStopping rules {entities} in account {account_id}, naming it {name}.
        slots:
          recipients: requestBody.recipients
          entities: requestBody.associated_entities
          account_id: path.account_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/alerts/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Search AutoStopping alerts
      effect: read
      questions:
      - Which AutoStopping alerts are set up in my account?
      - Can I find only the enabled alerts for a given AutoStopping rule?
      instructions:
      - text: List AutoStopping alerts in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Find AutoStopping alerts for entity {entity} that are enabled {enabled} in account {account_id}.
        slots:
          entity: requestBody.entity_id
          enabled: requestBody.enabled
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/alerts/{alert_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one AutoStopping alert
      effect: read
      questions:
      - What events and recipients does a specific AutoStopping alert have?
      - Can I look up an AutoStopping alert by its ID?
      instructions:
      - text: Get AutoStopping alert {alert} in account {account_id}.
        slots:
          alert: path.alert_id
          account_id: path.account_id
      - text: Show who gets notified by AutoStopping alert {alert} in account {account_id}.
        slots:
          alert: path.alert_id
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/alerts/{alert_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an AutoStopping alert
      effect: destructive
      questions:
      - How do I stop an AutoStopping alert from sending notifications for good?
      - Is deleting an AutoStopping alert a soft delete?
      instructions:
      - text: Delete AutoStopping alert {alert} in account {account_id}.
        slots:
          alert: path.alert_id
          account_id: path.account_id
      - text: Remove the AutoStopping notification {alert} from account {account_id}.
        slots:
          alert: path.alert_id
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'