Signal Types
WatchCron supports three signal types for fine-grained monitoring. Using all three gives you the best visibility into your job's behavior:
| Endpoint | Signal | Description |
|---|---|---|
/ping/{uuid} |
success | Default signal. Reports that the job completed successfully. This is the only required signal — everything else is optional. |
/ping/{uuid}/start |
start | Reports that the job has started. Enables run duration tracking in the dashboard. Helps distinguish between "job didn't start" and "job started but got stuck". |
/ping/{uuid}/fail |
fail | Reports an explicit failure. Triggers immediate notification without waiting for the grace period to expire. Use this in your error handling or catch blocks. |
Recommended pattern
For maximum reliability, use all three signals:
Full monitoring pattern
# 1. Signal start — job is beginning curl -fsS https://watchcron.com/ping/your-uuid/start # 2. Run your actual task /usr/local/bin/my-task.sh # 3. Signal success or failure based on exit code if [ $? -eq 0 ]; then curl -fsS https://watchcron.com/ping/your-uuid else curl -fsS https://watchcron.com/ping/your-uuid/fail fi