# Alarm

[Alarm filters](https://docs.trustgrid.io/docs/alarms/alarm-filters/) define criteria and thresholds for when events generate alert notifications. Configure alert channels (email, Slack, PagerDuty, OpsGenie, Teams, webhooks) and maintenance windows. Requires `alarms::read` permission.


## Retrieve all configured alarm filters and their trigger conditions

 - [GET /v2/alarm](https://apidocs.trustgrid.io/alarm/listalarms.md): Requires alarms::read permission.

## Create a new alarm filter to monitor events and trigger notifications

 - [POST /v2/alarm](https://apidocs.trustgrid.io/alarm/paths/~1v2~1alarm/post.md): Requires alarms::modify permission.

## Retrieve all configured notification channels for alarm delivery

 - [GET /v2/alarm-channel](https://apidocs.trustgrid.io/alarm/listalarmchannels.md)

## Configure a new notification channel for alarm delivery (email, Slack, etc.)

 - [POST /v2/alarm-channel](https://apidocs.trustgrid.io/alarm/paths/~1v2~1alarm-channel/post.md)

## Permanently remove a notification channel configuration

 - [DELETE /v2/alarm-channel/{uid}](https://apidocs.trustgrid.io/alarm/paths/~1v2~1alarm-channel~1%7Buid%7D/delete.md)

## Retrieve configuration details for a specific notification channel

 - [GET /v2/alarm-channel/{uid}](https://apidocs.trustgrid.io/alarm/getalarmchannel.md)

## Modify settings for an existing notification channel

 - [PUT /v2/alarm-channel/{uid}](https://apidocs.trustgrid.io/alarm/paths/~1v2~1alarm-channel~1%7Buid%7D/put.md)

## Cancel an active alert suppression window and resume normal notifications

 - [DELETE /v2/alarm/suppression](https://apidocs.trustgrid.io/alarm/paths/~1v2~1alarm~1suppression/delete.md)

## Retrieve current or upcoming alert suppression schedule details

 - [GET /v2/alarm/suppression](https://apidocs.trustgrid.io/alarm/getalarmsuppression.md)

## Schedule a time period to temporarily disable alarm notifications

 - [POST /v2/alarm/suppression](https://apidocs.trustgrid.io/alarm/paths/~1v2~1alarm~1suppression/post.md)

## Permanently remove an alarm filter and stop monitoring conditions

 - [DELETE /v2/alarm/{uid}](https://apidocs.trustgrid.io/alarm/paths/~1v2~1alarm~1%7Buid%7D/delete.md)

## Retrieve detailed configuration of a specific alarm filter

 - [GET /v2/alarm/{uid}](https://apidocs.trustgrid.io/alarm/getalarm.md)

## Modify trigger conditions and settings for an existing alarm filter

 - [PUT /v2/alarm/{uid}](https://apidocs.trustgrid.io/alarm/paths/~1v2~1alarm~1%7Buid%7D/put.md)