Create Alert Rule

What It Does

Defines an alert rule with a specific type (e.g., ssl_expiry, dns_changed, security_score_drop), trigger threshold, check window, notification channel (email), and cooldown period. The rule is evaluated continuously against live metrics. When conditions are met and the cooldown has elapsed, an alert is triggered and notifications are dispatched.

Why It's Useful

Proactive monitoring is the foundation of reliable infrastructure. Industry data shows that SSL certificate expiration is a leading cause of preventable outages — with best practices recommending alerts at 90, 30, 14, and 7 days before expiry. DNS change detection catches unauthorized modifications that could indicate DNS hijacking (an attack vector highlighted by OWASP and CISA). Automated alerting reduces Mean Time to Detect (MTTD) by up to 70%, enabling faster incident response.

Use Cases

Parameters

Response Fields

Code Examples

curl "https://api.edgedns.dev/v1/alerts/rules" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "type=ssl_expiry"

const response = await fetch(
  'https://api.edgedns.dev/v1/alerts/rules?type=ssl_expiry',
  {
    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',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'type': 'ssl_expiry'
    }
)

data = response.json()
print(data)

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.