Skip to main content
Alerts are generated automatically by InfraAudit when drift, vulnerability, compliance, or cost anomaly findings exceed configured thresholds. You can also create alerts manually. The alerts endpoints let you list, filter, acknowledge, and resolve alert findings. Base path: /api/v1/alerts

GET /alerts — list alerts

Returns a paginated list of alerts.

Query parameters

severity
string
Filter by severity: critical, high, medium, or low.
type
string
Filter by alert type: security, cost, compliance, or performance.
status
string
Filter by status: open, acknowledged, or resolved.
provider_id
integer
Filter by provider.
page
integer
default:"1"
Page number.
per_page
integer
default:"20"
Results per page. Maximum is 100.

Response


GET /alerts/ — get alert

Returns full details for a single alert.

POST /alerts — create alert (manual)

Creates a manual alert for a resource.

Request body

title
string
required
A short description of the alert.
type
string
required
Alert type: security, cost, compliance, or performance.
severity
string
required
Severity: critical, high, medium, or low.
resource_id
integer
Resource the alert is associated with.
description
string
Extended description or context.

POST /alerts//acknowledge — acknowledge an alert

Marks an alert as acknowledged. Returns 200 with the updated alert.

POST /alerts//resolve — resolve an alert

Marks an alert as resolved with an optional resolution note.

Request body (optional)

resolution_note
string
A note describing how the issue was resolved.

POST /alerts/bulk — bulk update alerts

Acknowledge or resolve multiple alerts in a single request.

Request body

ids
array
required
Array of alert IDs to update.
action
string
required
Action to apply: acknowledge or resolve.