---
title: "Evaluate"
method: POST
path: "/api/v1/alerts/rules/{rule_id}/evaluate"
tags: ["ALERTS_V1"]
---

# Evaluate

`POST /api/v1/alerts/rules/{rule_id}/evaluate`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/api/v1/alerts/rules/{rule_id}/evaluate`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Evaluate a rule. dry_run=True for read-only, False to record the run.

## Path parameters

- `rule_id` integer, required

## Request body

- EvaluateRequest
  - `dry_run` boolean

## Response `200`

Successful Response

- RunResultResponse
  - `display_context` object, nullable
  - `run_id` string, nullable
  - `rule_id` integer, nullable
  - `metric_name` string, required
  - `current_value` number, required
  - `previous_value` number, nullable
  - `change` number, nullable
  - `change_percent` number, nullable
  - `threshold_breached` boolean, required
  - `status` string, required
  - `error` string, nullable
  - `executed_at` string, date-time, required
  - `breaching_entities` object[], nullable: For per-entity ('ANY') rules: the warehouses that breached, each {entity, current_value, previous_value, change, change_percent}, worst first. Null for ordinary rules.
  - `request` object, nullable: Echo of the resolved request config (dry-run only)
  - `queries` QueryLogResponse[]: SQL queries executed during evaluation
    - `label` string, required
    - `sql` string, required
    - `params` object
    - `period_start` string, nullable
    - `period_end` string, nullable
    - `value` number, nullable
    - `elapsed_ms` number, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-23** `eebfc2f234e1`: 1 info
  - added the optional property `display_context` to the response with the `200` status

[Operation history](https://skmtc.dev/myaltimate/apis/myaltimate-api/changes/api/v1/alerts/rules/:rule_id/evaluate/post.md)

---

[API](https://skmtc.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)