Alerts API

Manage alerts and alert rules.

List Alerts

GET /api/v1/alerts

Query Parameters

Parameter	Type	Description
status	string	Filter by status (firing, resolved, silenced)
severity	string	Filter by severity (critical, warning, info)
service	string	Filter by service

Response

{
  "data": [
    {
      "id": "alt_abc123",
      "name": "High CPU Usage",
      "status": "firing",
      "severity": "warning",
      "service": "api-gateway",
      "message": "CPU usage is 92%",
      "started_at": "2025-01-15T10:00:00Z"
    }
  ]
}

Get Alert

GET /api/v1/alerts/:id

Acknowledge Alert

POST /api/v1/alerts/:id/acknowledge

{
  "comment": "Investigating the issue"
}

Resolve Alert

POST /api/v1/alerts/:id/resolve

List Alert Rules

GET /api/v1/alert-rules

Create Alert Rule

POST /api/v1/alert-rules

Request Body

{
  "name": "High CPU Alert",
  "condition": "cpu_percent > 80",
  "duration": "5m",
  "severity": "warning",
  "services": ["api-gateway", "auth-service"],
  "notifications": ["slack", "email"]
}

Silence Alerts

POST /api/v1/alerts/silence

{
  "matcher": {
    "service": "api-gateway"
  },
  "duration": "2h",
  "reason": "Planned maintenance"
}