🔔 Notification Router
One API call to reach a human. Agents send a message and a priority level — the router delivers it by email. No SMTP config, no credentials to manage.
Send a notification
If to is omitted, the email is delivered to your AgentUtils account email automatically.
curl -X POST https://www.agent-utils.com/api/notify \
-H "x-api-key: au_your_key" \
-H "Content-Type: application/json" \
-d '{"message":"Wire transfer of $5,000 is pending approval.","priority":"urgent"}'
# Response
{"success":true,"data":{
"id": "64f1a2b3c4d5e6f7a8b9c0d1",
"status": "sent",
"to": "you@example.com",
"subject": "[AgentUtils] 🚨 New notification",
"priority": "urgent",
"resendId": "re_abc123"
}}
Request body
| Field | Type | Required | Description |
|---|---|---|---|
| message | string | Yes | Body of the notification |
| priority | string | No | urgent · normal · low — default: normal |
| to | string | No | Recipient email. Defaults to your account email. |
| subject | string | No | Email subject line. Auto-generated from priority if omitted. |
| metadata | object | No | Arbitrary key-value data shown in the email body and stored with the record. |
Use with Checkpoint
Call /notify right after creating a checkpoint so the human knows to go approve it.
# 1. Create checkpoint
CHECKPOINT=$(curl -sX POST https://www.agent-utils.com/api/checkpoint \
-H "x-api-key: au_your_key" \
-H "Content-Type: application/json" \
-d '{"agentName":"finance-bot","taskDescription":"Wire $5,000","state":{...},"webhookUrl":"https://your-server.com/resume"}')
# 2. Notify the human immediately
ID=$(echo $CHECKPOINT | jq -r '.data.id')
curl -sX POST https://www.agent-utils.com/api/notify \
-H "x-api-key: au_your_key" \
-H "Content-Type: application/json" \
-d "{"message":"Agent wants to wire \$5,000. Approve here: https://www.agent-utils.com/dashboard/checkpoints/$ID","priority":"urgent"}"
List notification history
curl https://www.agent-utils.com/api/notify \
-H "x-api-key: au_your_key"
# Filter by status or priority
curl "https://www.agent-utils.com/api/notify?status=failed&priority=urgent" \
-H "x-api-key: au_your_key"
Python
import requests
requests.post(
"https://www.agent-utils.com/api/notify",
headers={"x-api-key": "au_your_key"},
json={
"message": "Task complete: report.pdf is ready.",
"priority": "normal",
"metadata": {"fileId": "abc123", "rows": 1042}
}
)
Environment variables
| Variable | Description |
|---|---|
| RESEND_API_KEY | Your Resend API key (required) |
| RESEND_FROM_EMAIL | Sender address — defaults to notify@www.agent-utils.com |