v1

latestOpenAPI 3.1.0MIT2026-07-1393128198.4 KB
Alerts

List alerts

List alerts with optional filtering by status, priority, type, activity state, monitor ID, and free-text search. Returns alerts sorted by most recent event by default.

get/internal/v1/alerts/{project_id}

Path parameters

project_idinteger required

Uptrace project ID.

Query parameters

searchstring

Free-text search across alert name and attributes. Supports scoped search (e.g., alert.status:resolved).

attrs[status][]AlertStatus[]

Filter by alert status. Can be repeated for multiple values.

attrs[priority][]AlertPriority[]

Filter by alert priority. Can be repeated for multiple values.

attrs[type][]AlertType[]

Filter by alert type. Can be repeated for multiple values.

attrs[activityState][]AlertActivityState[]

Filter by activity state. Can be repeated for multiple values.

attrs[monitorId][]integer[]

Filter by monitor ID. Can be repeated for multiple values.

sort_bystring

Field to sort by. Defaults to event.created_at.

sort_dir'ASC' | 'DESC'

Sort direction.

Sort direction. Defaults to DESC.

limitinteger

Limit number of results.

Response

List of alerts.

countinteger required

Total number of matching alerts.