> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger Monitor Run

> Manually trigger an enrichment run for a monitor.

## Authentication

Requires an API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_API_KEY
```

## Path parameters

<ParamField path="id" type="string" required>
  The monitor's unique identifier (UUID).
</ParamField>

### Example request

```bash theme={"dark"}
curl -X POST https://encrata.com/api/agent/monitors/a1b2c3d4-.../run \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response

```json theme={"dark"}
{
  "run_id": "b2c3d4e5-...",
  "status": "running",
  "message": "Run started for 25 emails"
}
```

<Note>
  Each email in the monitor costs 1 credit. The run is processed asynchronously — results appear in the run history once complete.
</Note>

## Webhook event

When a run completes with changes detected, a `monitor.run.completed` webhook is dispatched:

```json theme={"dark"}
{
  "event": "monitor.run.completed",
  "data": {
    "monitor_id": "a1b2c3d4-...",
    "monitor_name": "Engineering team",
    "run_id": "b2c3d4e5-...",
    "total_records": 25,
    "changes_detected": 3,
    "credits_used": 25
  },
  "created_at": "2026-05-04T12:30:00Z"
}
```