Delete Alert Rule
developer/v1/alerts/rules/:idPermanently removes an alert rule from active monitoring. The rule immediately stops evaluating and no further alerts will be generated. Historical alert data from this rule is retained in alert history for 30 days for audit and post-mortem purposes.
What It Does
Deletes the specified alert rule from the database. The operation is organization-scoped — you can only delete rules belonging to your organization. Returns a confirmation of deletion. Historical alerts previously triggered by this rule remain accessible via the alert history endpoints.
Why It's Useful
Clean up rules for decommissioned domains, consolidate duplicate monitoring after infrastructure changes, or remove test rules. Maintaining a tidy alerting configuration reduces cognitive overhead during incident response and ensures on-call engineers focus on actionable signals.
Use Cases
Domain Decommissioning
Remove all alert rules for domains being retired or transferred to another organization.
Eliminate false alerts from domains you no longer control.
Rule Consolidation
Delete granular per-domain rules after creating a comprehensive organizational monitoring policy.
Simplify alerting configuration while maintaining full coverage.
Post-Migration Cleanup
Remove rules for old infrastructure after migrating to new domains or cloud regions.
Keep monitoring aligned with current infrastructure topology.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Required | Alert rule ID to deleteExample: rule_abc123 |
Response Fields
| Field | Type | Description |
|---|---|---|
deleted | boolean | true if rule was successfully deleted |
Code Examples
curl "https://api.edgedns.dev/v1/alerts/rules/:id" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "domain=rule_abc123"const response = await fetch(
'https://api.edgedns.dev/v1/alerts/rules/:id?domain=rule_abc123',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);import requests
response = requests.get(
'https://api.edgedns.dev/v1/alerts/rules/:id',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={
'domain': 'rule_abc123'
}
)
data = response.json()
print(data)Read the full Delete Alert Rule guide
Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.
Read the guide →Related Endpoints
External References
Learn more about the standards and protocols behind this endpoint.
Try This Endpoint
Test the Delete Alert Rule endpoint live in the playground.