---
title: "Create alert rule or evaluate rules"
method: POST
path: "/api/alerts"
tags: ["Alerts"]
---

# Create alert rule or evaluate rules

`POST /api/alerts`

## Request body

- union
  - object
    - `name` string, required
    - `description` string
    - `entity_type` 'agent' | 'task' | 'session' | 'activity', required
    - `condition_field` string, required
    - `condition_operator` 'equals' | 'not_equals' | 'greater_than' | 'less_than' | 'contains' | 'count_above' | 'count_below' | 'age_minutes_above', required
    - `condition_value` string, required
    - `action_type` string
    - `action_config` object
    - `cooldown_minutes` integer
  - object
    - `action` 'evaluate', required

## Response `200`

Rules evaluated

- object
  - `evaluated` integer
  - `triggered` integer
  - `results` object[]
    - `rule_id` integer
    - `rule_name` string
    - `triggered` boolean
    - `reason` string

## Other responses

- `201` — Rule created
- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/builderz-labs/apis/mission-control-api.md) · [All operations](https://skmtc.net/builderz-labs/apis/mission-control-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/builderz-labs/mission-control-api/revisions/b920835b2793/schema)