---
title: "Changes to Update Alert"
method: PUT
path: "/api/v2/alerts/{id}"
---

# Changes to Update Alert

`PUT /api/v2/alerts/{id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 11 of 60 revisions.

- **2026-08-21** `578ecc427dd8` — 2 info
- **2026-08-11** `0c6c6e744406` — 1 warning
- **2026-07-08** `6f4381730123` — 1 info
- **2026-07-06** `e3a538a92f67` — 1 warning, 2 info
- **2026-05-13** `b3055248af4f` — 2 info
- **2026-04-17** `49ba4aeaa9b4` — 1 info
- **2026-04-17** `36a5514b1745` — 2 warning, 4 info
- **2026-04-16** `dbf09188d84e` — 4 warning, 4 info
- **2026-03-06** `d895d0cbdd27` — 4 info
- **2026-02-02** `e856dc2f1417` — 3 breaking, 28 warning, 1 info
- **2026-01-30** `ed852374c451` — 2 breaking, 1 warning, 30 info

## Changes

- **2026-08-21** `578ecc427dd8` — 2 info
  - added the new optional request property `allOf[#/components/schemas/Alert]/channels`
  - added the optional property `data/allOf[#/components/schemas/Alert]/channels` to the response with the `200` status
- **2026-08-11** `0c6c6e744406` — 1 warning
  - added the new `QUERY_TIMEOUT` enum value to the `data/allOf[subschema #2]/executionErrors/items/type` response property for the response status `200`
- **2026-07-08** `6f4381730123` — 1 info
  - added the non-success response with the status `403`
- **2026-07-06** `e3a538a92f67` — 1 warning, 2 info
  - added the new `PENDING` enum value to the `data/allOf[subschema #2]/state` response property for the response status `200`
  - added the new optional request property `allOf[#/components/schemas/Alert]/numConsecutiveWindows`
  - added the optional property `data/allOf[#/components/schemas/Alert]/numConsecutiveWindows` to the response with the `200` status
- **2026-05-13** `b3055248af4f` — 2 info
  - added the new optional request property `allOf[#/components/schemas/Alert]/note`
  - added the optional property `data/allOf[#/components/schemas/Alert]/note` to the response with the `200` status
- **2026-04-17** `49ba4aeaa9b4` — 1 info
  - added the optional property `data/allOf[subschema #2]/executionErrors` to the response with the `200` status
- **2026-04-17** `36a5514b1745` — 2 warning, 4 info
  - added the new `between` enum value to the `data/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the new `not_between` enum value to the `data/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the new optional request property `allOf[#/components/schemas/Alert]/thresholdMax`
  - added the new `between` enum value to the request property `allOf[#/components/schemas/Alert]/thresholdType`
  - added the new `not_between` enum value to the request property `allOf[#/components/schemas/Alert]/thresholdType`
  - added the optional property `data/allOf[#/components/schemas/Alert]/thresholdMax` to the response with the `200` status
- **2026-04-16** `dbf09188d84e` — 4 warning, 4 info
  - added the new `above_exclusive` enum value to the `data/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the new `below_or_equal` enum value to the `data/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the new `equal` enum value to the `data/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the new `not_equal` enum value to the `data/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the new `above_exclusive` enum value to the request property `allOf[#/components/schemas/Alert]/thresholdType`
  - added the new `below_or_equal` enum value to the request property `allOf[#/components/schemas/Alert]/thresholdType`
  - added the new `equal` enum value to the request property `allOf[#/components/schemas/Alert]/thresholdType`
  - added the new `not_equal` enum value to the request property `allOf[#/components/schemas/Alert]/thresholdType`
- **2026-03-06** `d895d0cbdd27` — 4 info
  - added the new optional request property `allOf[#/components/schemas/Alert]/scheduleOffsetMinutes`
  - added the new optional request property `allOf[#/components/schemas/Alert]/scheduleStartAt`
  - added the optional property `data/allOf[#/components/schemas/Alert]/scheduleOffsetMinutes` to the response with the `200` status
  - added the optional property `data/allOf[#/components/schemas/Alert]/scheduleStartAt` to the response with the `200` status
- **2026-02-02** `e856dc2f1417` — 3 breaking, 28 warning, 1 info
  - added `#/components/schemas/Alert, subschema #2` to the request body `allOf` list
  - the request's body type/format changed from `object`/`` to ``/``
  - the `data` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the request property `channel`
  - removed the request property `dashboardId`
  - removed the request property `groupBy`
  - removed the request property `interval`
  - removed the request property `message`
  - removed the request property `name`
  - removed the request property `savedSearchId`
  - removed the request property `source`
  - removed the request property `threshold`
  - removed the request property `thresholdType`
  - removed the request property `tileId`
  - removed the optional property `data/channel` from the response with the `200` status
  - removed the optional property `data/createdAt` from the response with the `200` status
  - removed the optional property `data/dashboard` from the response with the `200` status
  - removed the optional property `data/groupBy` from the response with the `200` status
  - removed the optional property `data/id` from the response with the `200` status
  - removed the optional property `data/interval` from the response with the `200` status
  - removed the optional property `data/message` from the response with the `200` status
  - removed the optional property `data/name` from the response with the `200` status
  - removed the optional property `data/savedSearch` from the response with the `200` status
  - removed the optional property `data/silenced` from the response with the `200` status
  - removed the optional property `data/source` from the response with the `200` status
  - removed the optional property `data/state` from the response with the `200` status
  - removed the optional property `data/team` from the response with the `200` status
  - removed the optional property `data/threshold` from the response with the `200` status
  - removed the optional property `data/thresholdType` from the response with the `200` status
  - removed the optional property `data/tileId` from the response with the `200` status
  - removed the optional property `data/updatedAt` from the response with the `200` status
  - added `#/components/schemas/Alert, subschema #2` to the `data` response property `allOf` list for the response status `200`
- **2026-01-30** `ed852374c451` — 2 breaking, 1 warning, 30 info
  - the request's body type/format changed from ``/`` to `object`/``
  - the `data` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/Alert, subschema #2` from the request body `allOf` list
  - added the new optional request property `channel`
  - added the new optional request property `dashboardId`
  - added the new optional request property `groupBy`
  - added the new optional request property `interval`
  - added the new optional request property `message`
  - added the new optional request property `name`
  - added the new optional request property `savedSearchId`
  - added the new optional request property `source`
  - added the new optional request property `threshold`
  - added the new optional request property `thresholdType`
  - added the new optional request property `tileId`
  - removed the non-success response with the status `403`
  - added the optional property `data/channel` to the response with the `200` status
  - added the optional property `data/createdAt` to the response with the `200` status
  - added the optional property `data/dashboard` to the response with the `200` status
  - added the optional property `data/groupBy` to the response with the `200` status
  - added the optional property `data/id` to the response with the `200` status
  - added the optional property `data/interval` to the response with the `200` status
  - added the optional property `data/message` to the response with the `200` status
  - added the optional property `data/name` to the response with the `200` status
  - added the optional property `data/savedSearch` to the response with the `200` status
  - added the optional property `data/silenced` to the response with the `200` status
  - added the optional property `data/source` to the response with the `200` status
  - added the optional property `data/state` to the response with the `200` status
  - added the optional property `data/team` to the response with the `200` status
  - added the optional property `data/threshold` to the response with the `200` status
  - added the optional property `data/thresholdType` to the response with the `200` status
  - added the optional property `data/tileId` to the response with the `200` status
  - added the optional property `data/updatedAt` to the response with the `200` status
  - removed `#/components/schemas/Alert, subschema #2` from the `data` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api/docs/api/v2/alerts/:id/put.md) · [API](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api.md) · [Page](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api/changes/api/v2/alerts/:id/put)
