Alerts & Notifications

curl -X POST https://api.alterlab.io/api/v1/alerts/rules \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "High failure rate on amazon.com",
    "alert_type": "domain_failure_rate",
    "conditions": {
      "threshold": 50,
      "window_minutes": 60,
      "min_requests": 10
    },
    "domain_filter": ["amazon.com"],
    "channels": {
      "email": true
    },
    "cooldown_minutes": 120
  }'

curl https://api.alterlab.io/api/v1/alerts/rules \
  -H "Authorization: Bearer your_jwt_token"

# Filter by type
curl "https://api.alterlab.io/api/v1/alerts/rules?alert_type=credit_threshold" \
  -H "Authorization: Bearer your_jwt_token"

# Include disabled rules
curl "https://api.alterlab.io/api/v1/alerts/rules?include_inactive=true" \
  -H "Authorization: Bearer your_jwt_token"

curl https://api.alterlab.io/api/v1/alerts/rules/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer your_jwt_token"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "organization_id": "org_abc123",
  "name": "High failure rate on amazon.com",
  "alert_type": "domain_failure_rate",
  "conditions": {
    "threshold": 50,
    "window_minutes": 60,
    "min_requests": 10
  },
  "domain_filter": ["amazon.com"],
  "channels": { "email": true },
  "is_active": true,
  "last_triggered_at": "2026-03-20T14:30:00Z",
  "cooldown_minutes": 120,
  "created_at": "2026-03-15T10:00:00Z",
  "updated_at": "2026-03-15T10:00:00Z"
}

# Tighten the threshold and add webhook delivery
curl -X PATCH https://api.alterlab.io/api/v1/alerts/rules/550e8400-... \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{
    "conditions": {
      "threshold": 30,
      "window_minutes": 30,
      "min_requests": 5
    },
    "channels": {
      "email": true,
      "webhook_id": "wh_abc123"
    }
  }'

# Disable a rule
curl -X PATCH https://api.alterlab.io/api/v1/alerts/rules/550e8400-... \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{"is_active": false}'

curl -X DELETE https://api.alterlab.io/api/v1/alerts/rules/550e8400-... \
  -H "Authorization: Bearer your_jwt_token"

"channels": {
  "email": true
}

"channels": {
  "email": true,
  "webhook_id": "wh_abc123"
}

{
  "alert_rule_id": "550e8400-e29b-41d4-a716-446655440000",
  "alert_type": "domain_failure_rate",
  "message": "Failure rate for amazon.com exceeded 50% (63%) in the last 60 minutes",
  "details": {
    "domain": "amazon.com",
    "failure_rate": 63.2,
    "window_minutes": 60,
    "total_requests": 38,
    "failed_requests": 24
  },
  "created_at": "2026-03-24T10:15:00Z"
}

{
  "name": "Amazon & eBay failure rate",
  "alert_type": "domain_failure_rate",
  "conditions": {
    "threshold": 40,
    "window_minutes": 30,
    "min_requests": 20
  },
  "domain_filter": ["amazon.com", "ebay.com"],
  "channels": { "email": true }
}

# List recent alerts
curl "https://api.alterlab.io/api/v1/alerts/history?limit=20" \
  -H "Authorization: Bearer your_jwt_token"

# Filter by rule
curl "https://api.alterlab.io/api/v1/alerts/history?rule_id=550e8400-..." \
  -H "Authorization: Bearer your_jwt_token"

# Filter by type
curl "https://api.alterlab.io/api/v1/alerts/history?alert_type=credit_threshold" \
  -H "Authorization: Bearer your_jwt_token"

{
  "alerts": [
    {
      "id": "a1b2c3d4-...",
      "alert_rule_id": "550e8400-...",
      "alert_type": "domain_failure_rate",
      "message": "Failure rate for amazon.com exceeded 50% (63%) in the last 60 minutes",
      "details": {
        "domain": "amazon.com",
        "failure_rate": 63.2,
        "total_requests": 38,
        "failed_requests": 24
      },
      "delivered_via": {
        "email": true,
        "webhook": "delivered"
      },
      "created_at": "2026-03-24T10:15:00Z"
    }
  ],
  "total": 42
}

import requests

API_URL = "https://api.alterlab.io/api/v1"
HEADERS = {
    "Authorization": "Bearer your_jwt_token",
    "Content-Type": "application/json",
}

# Create a credit threshold alert
rule = requests.post(
    f"{API_URL}/alerts/rules",
    headers=HEADERS,
    json={
        "name": "Low credit warning",
        "alert_type": "credit_threshold",
        "conditions": {"threshold_percent": 20},
        "channels": {"email": True},
        "cooldown_minutes": 30,
    },
).json()

print(f"Alert rule created: {rule['id']}")
print(f"Type: {rule['alert_type']}, Active: {rule['is_active']}")

# Create a failure rate alert for specific domains
failure_rule = requests.post(
    f"{API_URL}/alerts/rules",
    headers=HEADERS,
    json={
        "name": "E-commerce failure spike",
        "alert_type": "domain_failure_rate",
        "conditions": {
            "threshold": 40,
            "window_minutes": 30,
            "min_requests": 10,
        },
        "domain_filter": ["amazon.com", "ebay.com", "walmart.com"],
        "channels": {"email": True, "webhook_id": "wh_abc123"},
        "cooldown_minutes": 60,
    },
).json()

print(f"Failure alert created: {failure_rule['id']}")

# List all active rules
rules = requests.get(
    f"{API_URL}/alerts/rules",
    headers=HEADERS,
).json()

for r in rules["rules"]:
    status = "active" if r["is_active"] else "disabled"
    print(f"  {r['name']} ({r['alert_type']}) — {status}")

# Check alert history
history = requests.get(
    f"{API_URL}/alerts/history?limit=10",
    headers=HEADERS,
).json()

print(f"\nRecent alerts ({history['total']} total):")
for alert in history["alerts"]:
    print(f"  [{alert['created_at']}] {alert['alert_type']}: {alert['message']}")

# Disable a rule
requests.patch(
    f"{API_URL}/alerts/rules/{rule['id']}",
    headers=HEADERS,
    json={"is_active": False},
)
print(f"\nRule {rule['id']} disabled")

const API_URL = "https://api.alterlab.io/api/v1";
const headers = {
  Authorization: "Bearer your_jwt_token",
  "Content-Type": "application/json",
};

// Create a response time spike alert
const rule = await fetch(`${API_URL}/alerts/rules`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    name: "Slow response warning",
    alert_type: "response_time_spike",
    conditions: {
      threshold_seconds: 15,
      window_minutes: 30,
      min_requests: 5,
    },
    channels: { email: true },
    cooldown_minutes: 60,
  }),
}).then((r) => r.json());

console.log(`Rule created: ${rule.id} (${rule.alert_type})`);

// Create a consecutive failures alert
const consRule = await fetch(`${API_URL}/alerts/rules`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    name: "Consecutive failure detector",
    alert_type: "job_consecutive_failures",
    conditions: { consecutive_count: 5 },
    channels: { email: true, webhook_id: "wh_abc123" },
    cooldown_minutes: 15,
  }),
}).then((r) => r.json());

console.log(`Rule created: ${consRule.id}`);

// List all rules (including disabled)
const list = await fetch(
  `${API_URL}/alerts/rules?include_inactive=true`,
  { headers }
).then((r) => r.json());

for (const r of list.rules) {
  const status = r.is_active ? "active" : "disabled";
  console.log(`  ${r.name} (${r.alert_type}) — ${status}`);
}

// Browse alert history filtered by type
const history = await fetch(
  `${API_URL}/alerts/history?alert_type=response_time_spike&limit=10`,
  { headers }
).then((r) => r.json());

console.log(`\nRecent alerts (${history.total} total):`);
for (const a of history.alerts) {
  console.log(`  [${a.created_at}] ${a.message}`);
}

// Update rule — tighten threshold
await fetch(`${API_URL}/alerts/rules/${rule.id}`, {
  method: "PATCH",
  headers,
  body: JSON.stringify({
    conditions: {
      threshold_seconds: 10,
      window_minutes: 15,
      min_requests: 3,
    },
  }),
});

console.log(`\nRule ${rule.id} threshold tightened`);

// Delete a rule
await fetch(`${API_URL}/alerts/rules/${consRule.id}`, {
  method: "DELETE",
  headers,
});

console.log(`Rule ${consRule.id} deleted`);