---
title: "Evaluate Drift"
method: POST
path: "/api/v1/agents/{agent_id}/drift/evaluate"
tags: ["drift-alerts"]
---

# Evaluate Drift

`POST /api/v1/agents/{agent_id}/drift/evaluate`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/agents/{agent_id}/drift/evaluate`
- Auth: none declared

## Path parameters

- `agent_id` string, uuid, required

## Response `200`

Successful Response

- DriftEvaluateResult
  - `agent_id` string, uuid, required
  - `alerts_created` integer, required
  - `alerts` DriftAlertRead[], required
    - `id` string, uuid, required
    - `agent_id` string, uuid, required
    - `metric` 'score' | 'pass_rate' | 'cost' | 'latency', required
    - `event` string, required
    - `direction` 'up' | 'down', required
    - `bucket_date` string, date, required
    - `window_buckets` integer, required
    - `baseline_mean` number, required
    - `baseline_std` number, required
    - `observed` number, required
    - `z` number, required
    - `delta` number, required
    - `run_ids` string[], required
    - `blueprint_version_id` string, uuid, nullable, required
    - `blueprint_version_number` integer, nullable, required
    - `created_at` string, date-time, required
    - `notified_at` string, date-time, nullable, required
    - `acknowledged_at` string, date-time, nullable, required

## Other responses

- `422`: Validation Error
- `429`: Rate limited; body carries retry_after_seconds

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)