---
title: "Delete a metric alarm"
method: DELETE
path: "/orgs/{org_id}/alarms/{alarm_id}"
tags: ["alarms"]
---

# Delete a metric alarm

`DELETE /orgs/{org_id}/alarms/{alarm_id}`

## Request

- Base URL: `https://api.timbal.ai`
- URL: `https://api.timbal.ai/orgs/{org_id}/alarms/{alarm_id}`
- Auth: HTTP bearer

Delete a metric alarm and its channel links.

Needs `alarms.manage` for an org-level alarm, or `projects.alarms.manage` on the owning project for a project alarm.

## Path parameters

- `org_id` string, required
- `alarm_id` string, required

## Response `204`

Alarm deleted

- unknown

## Other responses

- `403`: Forbidden
- `404`: Not found

## Changes

- **2026-07-28** `dd7e398ce0d3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/changes/orgs/:org_id/alarms/:alarm_id/delete.md)

---

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