Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Arvo-AI/aurora/llms.txt
Use this file to discover all available pages before exploring further.
GET /api/incidents
Retrieves all incidents for the current user. Returns incidents in reverse chronological order (most recent first), excluding merged incidents.
Authentication
Requires user authentication via cookies or headers. The user_id is extracted from the request.
Query Parameters
This endpoint does not accept query parameters. Results are limited to 100 incidents.
Response
Returns an object containing an array of incident objects.
Array of incident objects
Source of the alert (e.g., “grafana”, “datadog”, “netdata”, “pagerduty”, “splunk”, “jenkins”, “cloudbees”, “dynatrace”)
ID of the alert in the source system
Current status of the incident. Possible values: investigating, analyzed, merged, resolved
Severity level of the incident (e.g., “critical”, “warning”, “info”)
Alert information
Service affected by the alert
Source system for the alert
URL to view the alert in the source system
Additional metadata about the alert (JSONB)
Status of Aurora’s RCA analysis. Possible values: idle, running, complete, error
Aurora’s summary of the incident investigation
ID of the chat session for RCA investigation (UUID)
Currently active tab in the UI. Possible values: thoughts, chat
Number of alerts correlated to this incident
List of services affected by correlated alerts
If this incident was merged, the UUID of the target incident
Title of the incident this was merged into
ISO 8601 timestamp when the incident started
ISO 8601 timestamp when the incident was analyzed
ISO 8601 timestamp when the incident record was created
ISO 8601 timestamp when the incident was last updated
Example Request
curl -X GET "https://api.aurora.example.com/api/incidents" \
-H "Cookie: session_token=YOUR_SESSION_TOKEN"
Example Response
{
"incidents": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"sourceType": "grafana",
"sourceAlertId": "12345",
"status": "investigating",
"severity": "critical",
"alert": {
"title": "High CPU usage on web-server-01",
"service": "web-server",
"source": "grafana",
"sourceUrl": "https://grafana.com/alerting/12345",
"metadata": {
"threshold": "80%",
"currentValue": "95%"
}
},
"auroraStatus": "running",
"summary": "Investigating high CPU usage...",
"chatSessionId": "abc123-session-id",
"activeTab": "thoughts",
"correlatedAlertCount": 3,
"affectedServices": ["web-server", "api-gateway"],
"startedAt": "2024-03-03T10:30:00Z",
"analyzedAt": null,
"createdAt": "2024-03-03T10:30:05Z",
"updatedAt": "2024-03-03T10:45:00Z"
}
]
}
Response Codes
Successfully retrieved incidents
Missing user_id (authentication failed)
Failed to retrieve incidents
Notes
- Results are limited to 100 most recent incidents
- Incidents with status
merged are excluded from results
- Results are ordered by
started_at in descending order (most recent first)
- Requires Row Level Security (RLS) context to be set with the user’s ID