---
title: "Update alarm"
method: POST
path: "/alarms/update"
tags: ["Alarms"]
---

# Update alarm

`POST /alarms/update`

## Request

- Base URL: `https://api.databuddy.cc`
- URL: `https://api.databuddy.cc/alarms/update`
- Auth: API key in header `x-api-key`

Updates an existing alarm and its destinations.

## Request body

- object
  - `alarmId` string, required
  - `name` string
  - `description` string, nullable
  - `enabled` boolean
  - `websiteId` string, nullable
  - `triggerType` 'uptime' | 'traffic_spike' | 'error_rate'
  - `triggerConditions` object
  - `destinations` union[]
    - union
      - object
        - `type` 'slack', required
        - `identifier` string, required
        - `config` object
      - object
        - `type` 'webhook', required
        - `identifier` string, uri, required
        - `config` object
          - `headers` object
          - `method` 'GET' | 'POST' | 'PUT' | 'PATCH'
      - object
        - `type` 'email', required
        - `identifier` string, email, required
        - `config` object

## Response `200`

OK

- object
  - `id` string, required
  - `organizationId` string, required
  - `websiteId` string, nullable, required
  - `name` string, required
  - `description` string, nullable, required
  - `enabled` boolean, required
  - `triggerType` string, required
  - `triggerConditions` object, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `destinations` object[], required
    - `id` string, required
    - `alarmId` string, required
    - `type` string, required
    - `identifier` string, required
    - `config` object, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `403`: 403
- `404`: 404
- `409`: 409
- `429`: 429
- `500`: 500
- `503`: 503

---

[API](https://skmtc.dev/databuddy/apis/databuddy-api.md) - [All operations](https://skmtc.dev/databuddy/apis/databuddy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/databuddy/apis/databuddy-api/revisions/ddfbba648d52?raw)