---
title: "Find alerts"
method: GET
path: "/v1/private/alerts"
tags: ["Alerts"]
---

# Find alerts

`GET /v1/private/alerts`

Find alerts

## Query parameters

- `page` integer
- `size` integer
- `sorting` string
- `filters` string

## Response `200`

OK

- AlertPagePublic
  - `page` integer
  - `size` integer
  - `total` integer
  - `content` AlertPublic[]
    - `id` string, uuid
    - `name` string
    - `enabled` boolean
    - `alert_type` 'general' | 'slack' | 'pagerduty'
    - `metadata` object
    - `webhook` WebhookPublic, required
      - `id` string, uuid
      - `name` string
      - `url` string, required
      - `secret_token` string
      - `headers` object
      - `created_at` string, date-time
      - `created_by` string
      - `last_updated_at` string, date-time
      - `last_updated_by` string
    - `triggers` AlertTriggerPublic[]
      - `id` string, uuid
      - `alert_id` string, uuid
      - `event_type` 'trace:errors' | 'trace:feedback_score' | 'trace_thread:feedback_score' | 'prompt:created' | 'prompt:committed' | 'trace:guardrails_triggered' | 'prompt:deleted' | 'experiment:finished' | 'trace:cost' | 'trace:latency', required
      - `trigger_configs` AlertTriggerConfigPublic[]
        - `id` string, uuid
        - `alert_trigger_id` string, uuid
        - `type` 'scope:project' | 'threshold:feedback_score' | 'threshold:cost' | 'threshold:latency' | 'threshold:errors' | 'filter:guardrail_type', required
        - `config_value` object
        - `group_index` integer — Groups configs within a trigger: same group_index means AND between configs, different group_index means OR between groups. Null means a legacy/singleton group of one config. Always null for scope:project configs.
        - `created_at` string, date-time
        - `created_by` string
        - `last_updated_at` string, date-time
        - `last_updated_by` string
      - `created_at` string, date-time
      - `created_by` string
    - `created_at` string, date-time
    - `created_by` string
    - `last_updated_at` string, date-time
    - `last_updated_by` string
    - `project_id` string, uuid — Optional project scope for this alert. When set, the alert is scoped to the specified project. Do NOT also provide a 'scope:project' trigger config — the system will create it automatically from this field. Sending both project_id and a scope:project trigger config will result in an error.
  - `sortable_by` string[]

---

[API](https://skmtc.net/comet-ml/apis/opik-rest-api.md) · [All operations](https://skmtc.net/comet-ml/apis/opik-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/comet-ml/opik-rest-api/versions/4ed2fbc97cc3/schema)