---
title: "Update alarm"
method: PUT
path: "/v2/Alarms/{Sid}"
---

# Update alarm

`PUT /v2/Alarms/{Sid}`

## Request

- Base URL: `https://monitor.twilio.com`
- URL: `https://monitor.twilio.com/v2/Alarms/{Sid}`
- Auth: HTTP basic

## Path parameters

- `Sid` string, required

## Request body

- MonitorV2AlarmCreateObject: Alarm object
  - `friendlyName` string, required: Friendly name for alarm
  - `queryType` 'ERROR_CODE' | 'LOG_LEVEL' | 'ALL', required: Type of query
  - `query` string: Value to query for
  - `triggerValue` integer, required: Threshold to send customer alarm notification
  - `timeWindow` 'FIVE_MINS' | 'FIFTEEN_MINS' | 'ONE_HOUR' | 'TWELVE_HOURS' | 'ONE_DAY', required: Time window for alarm to trigger
  - `email` string[]: Email notifications to send
  - `webhook` string: Webhook notification to send
  - `consoleIndicator` boolean: Whether to send console notifications
  - `description` string, required: Description for the alarm.
  - `enabled` boolean, required: Is alarm enbled? Default is true.

## Response `200`

Ok

- MonitorV2AlarmSidRepsonse: Alarm sid
  - `sid` string

## Other responses

- `400`: BAD REQUEST
- `401`: UNAUTHORIZED
- `404`: NOT FOUND
- `429`: TOO MANY REQUEST
- `500`: INTERNAL SERVER ERROR

## Changes

- **2024-12-05** (v2) `7811ecfc26f4`: 35 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `429` status
  - …31 more

[Operation history](https://skmtc.dev/twilio/apis/twilio-monitor/changes/v2/Alarms/:Sid/put.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-monitor.md) - [All operations](https://skmtc.dev/twilio/apis/twilio-monitor/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/twilio-monitor/revisions/9c4c6ced36aa?raw)