Skip to main content
POST
/
api
/
agent
/
monitors
/
{id}
/
run
Trigger Monitor Run
curl --request POST \
  --url https://encrata.com/api/agent/monitors/{id}/run \
  --header 'Authorization: Bearer <token>'

​
Authentication

Requires an API key in the Authorization header. 
Authorization: Bearer YOUR_API_KEY

​
Path parameters

​
id
string
required
The monitor’s unique identifier (UUID).

​
Example request

curl -X POST https://encrata.com/api/agent/monitors/a1b2c3d4-.../run \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "run_id": "b2c3d4e5-...",
  "status": "running",
  "message": "Run started for 25 emails"
}
Each email in the monitor costs 1 credit. The run is processed asynchronously — results appear in the run history once complete.

​
Webhook event

When a run completes with changes detected, a monitor.run.completed webhook is dispatched: 
{
  "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"
}