# alert_status_changed

> For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt).


Triggered when an alert's runtime status for a subscription changes between `IN_ALARM` and `WITHIN_LIMIT`. This indicates a change in the subscription's usage relative to the alert threshold and applies only to usage-based billing.

## Event Schema

- `id` (string)
  Unique identifier for the event
- `occurred_at` (integer (unix timestamp))
  Timestamp when the event occurred
- `source` (string)
  Source that triggered the event (e.g., admin_console, api, scheduled_job)
- `object` (string)
  Always "event" for webhook events
- `api_version` (string)
  API version used for this event
- `event_type` (string)
  Type of the webhook event
- `webhook_status` (string)
  Status of the webhook delivery

- `content` (object)
  Content of the event

  - `alert` (object)
    The alert object affected by this event
  - `alert_status` (object)
    The alert_status object affected by this event

## Sample Payload

```json
{
    "id": "ev_alertstatl6g6wj",
    "occurred_at": 1788418920,
    "source": "admin_console",
    "object": "event",
    "api_version": "v2",
    "event_type": "alert_status_changed",
    "webhook_status": "not_applicable",
    "content": {
        "alert": {
            "id": "alert___dev__3Nl7purV3LwbKYH",
            "name": "GPT-4o usage threshold",
            "description": "Notify when usage crosses 90% of quota",
            "type": "usage_exceeded",
            "metered_feature_id": "gpt4o-usage",
            "...": "..."
        },
        "alert_status": {
            "id": "alert_status_example_id",
            "...": "..."
        }
    }
}
```