GET /api/v1/incidents

{
  "data": [
    {
      "id": "inc_1234567890",
      "title": "High Error Rate on API Gateway",
      "status": "triggered",
      "severity": "critical",
      "alert_count": 3,
      "triggered_at": "2024-01-15T10:30:00Z",
      "acknowledged_at": null,
      "resolved_at": null,
      "affected_services": ["api-gateway", "auth-service"]
    }
  ],
  "meta": {
    "total": 12,
    "limit": 50
  }
}

GET /api/v1/incidents/:id

{
  "data": {
    "id": "inc_1234567890",
    "title": "High Error Rate on API Gateway",
    "summary": "Error rate exceeded threshold of 5% for more than 5 minutes",
    "status": "acknowledged",
    "severity": "critical",
    "triggered_at": "2024-01-15T10:30:00Z",
    "acknowledged_at": "2024-01-15T10:32:00Z",
    "acknowledged_by": "[email protected]",
    "resolved_at": null,
    "affected_services": ["api-gateway", "auth-service"],
    "alerts": [
      {
        "id": "alert_001",
        "name": "Error Rate High",
        "state": "firing",
        "current_value": 8.5
      }
    ],
    "timeline": [
      {
        "event": "triggered",
        "timestamp": "2024-01-15T10:30:00Z"
      },
      {
        "event": "acknowledged",
        "timestamp": "2024-01-15T10:32:00Z",
        "by": "[email protected]"
      }
    ]
  }
}

POST /api/v1/incidents/:id/acknowledge

{
  "by": "[email protected]",
  "note": "Investigating the root cause"
}

{
  "data": {
    "id": "inc_1234567890",
    "status": "acknowledged",
    "acknowledged_at": "2024-01-15T10:32:00Z",
    "acknowledged_by": "[email protected]"
  }
}

POST /api/v1/incidents/:id/resolve

{
  "by": "[email protected]",
  "note": "Root cause was a misconfigured load balancer. Fixed and deployed."
}

{
  "data": {
    "id": "inc_1234567890",
    "status": "resolved",
    "resolved_at": "2024-01-15T11:00:00Z",
    "resolved_by": "[email protected]",
    "resolution_note": "Root cause was a misconfigured load balancer. Fixed and deployed."
  }
}