---
title: "Create an alert rule"
method: POST
path: "/v1/metric-alerts"
tags: ["Metric alerts"]
---

# Create an alert rule

`POST /v1/metric-alerts`

## Request body

- MetricAlertCreate
  - `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

## Response `200`

Created

## Other responses

- `400` — Invalid request

---

[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/versions/804359ead65a/schema)