---
title: "List alert rules"
method: GET
path: "/v1/metric-alerts"
tags: ["Metric alerts"]
---

# List alert rules

`GET /v1/metric-alerts`

Manager-aware — managers see every rule on the artifact; viewers see only their own.

## Query parameters

- `artifact_id` string, required

## Response `200`

Alert rules

- object
  - `alerts` MetricAlert[]
    - `artifact_id` string, required
    - `metric_id` string, required
    - `name` string, required
    - `condition` MetricCondition, required
      - `op` 'gt' | 'gte' | 'lt' | 'lte' | 'eq' | 'neq', required
      - `value` number, required
    - `schedule` string, required — 5-field cron expression.
    - `destination` MetricDestination, required
      - `kind` 'slack' | 'email' | 'discord' | 'webhook' | 'http_get' | 'telegram', required
      - `config` object, required — Destination config matching the kind (see Jobs config interfaces).
    - `message` string
    - `cooldown_seconds` integer
    - `id` string
    - `enabled` boolean
    - `created_at` integer

---

[API](https://skmtc.net/shareout/apis/shareout-rest-api.md) · [All operations](https://skmtc.net/shareout/apis/shareout-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shareout/shareout-rest-api/revisions/804359ead65a/schema)