Documentation

Everything you need to integrate CronAlert.

# quick start

1. Create a monitor at /dashboard

2. Copy your ping URL

3. Add it to your cron job:

0 2 * * * /backup.sh && curl -s https://henry-cronalert.vercel.app/api/ping/YOUR_TOKEN

That's it. If the job stops pinging, you get an email.

# rest api v1

Base URL: https://henry-cronalert.vercel.app/api/v1
Auth: Authorization: Bearer <supabase_access_token>

GET/api/v1/monitors

List all your monitors

{ "data": [...], "count": 3 }
POST/api/v1/monitors

Create a monitor

{ "name": "daily-backup", "interval_minutes": 1440, "grace_minutes": 30, "alert_email": "you@example.com" }
GET/api/v1/monitors/:id

Get monitor + recent pings + alerts

PATCH/api/v1/monitors/:id

Update a monitor

DELETE/api/v1/monitors/:id

Delete a monitor

GET/api/ping/:token

Record a heartbeat (add this to your cron job)

# mcp (ai agent integration)

The MCP endpoint lets AI agents manage your monitors via structured tool calls.

# Get the manifest
GET https://henry-cronalert.vercel.app/api/mcp

# Call a tool
POST https://henry-cronalert.vercel.app/api/mcp
Authorization: Bearer <token>
Content-Type: application/json

{
  "tool": "list_monitors",
  "parameters": {}
}

# Available tools:
# - list_monitors
# - create_monitor
# - get_monitor
# - delete_monitor
# - get_status_summary