---
title: "Deletes alarm rule"
method: DELETE
path: "/v1/enterprise/{enterprise_id}/alarmrules/{alarm_id}/"
tags: ["esper_cloud_api_Alarms"]
---

# Deletes alarm rule

`DELETE /v1/enterprise/{enterprise_id}/alarmrules/{alarm_id}/`

⚠️ Android only. 

Permanently deletes an alarm rule identified by its UUID alarm_id. This action is irreversible — the rule, its configuration, and its association with any alert channels are removed immediately. Historical firing data for the rule is also no longer accessible after deletion.

**Common use cases**

Removing alarm rules that are no longer relevant after a fleet restructure or deployment phase ends

Cleaning up duplicate or misconfigured rules created during setup

Decommissioning monitoring configurations for device groups that have been dissolved

**Best practices**

Retrieve the rule with GET /v1/enterprise/{enterprise_id}/alarmrules/{alarm_id}/ before deleting to confirm it is the correct rule — this action cannot be undone

If the intent is to stop the rule from firing temporarily rather than permanently remove it, consider using PATCH /v1/enterprise/{enterprise_id}/alarmrules/{alarm_id}/ to set is_active=false instead

Review firing history via GET /alarmrules/{alarm_id}/alarmhistory/ before deleting if the rule's historical trigger data is needed for reporting or auditing purposes — this data will not be recoverable after deletion

Note that deleting an alarm rule does not delete the alert channels it referenced — channels are enterprise-level resources and remain available for use by other rules

## Path parameters

- `enterprise_id` string, required
- `alarm_id` string, required

## Response `204`

The resource was deleted successfully.

## Other responses

- `400` — Invalid request.
- `401` — Authorization information is missing or invalid.
- `403` — Forbidden, no permission to perform this action.
- `404` — Not Found.
- `500` — Internal server error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/e1f64cbb488e/schema)