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}

Request

Base URL
https://api.uptrace.dev
Auth
- HTTP bearer
- or API key in query parameter auth_token
TypeScript
https://skmtc.dev/uptrace/apis/uptrace-json-api/docs/internal/v1/alerts/:project_id/get.ts
A function with typed inputs. Its response is checked against the schema.

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.

Changes

No recorded changes to this operation across all 1 revision of this API.