Skip to content

Cron Jobs

The Cron module replaces tools like Cronitor and Inngest for scheduled job management.

Planned Features

Cron scheduling - Standard cron expressions
Webhook triggers - Call any HTTP endpoint
Retry logic - Automatic retries on failure
Run history - View past executions and results
Alerting - Get notified on failures

Quick Start (Preview)

# Create a scheduled job
soup cron create daily-cleanup \
  --schedule "0 0 * * *" \
  --url https://api.myapp.com/cleanup

# Create a job that runs every 5 minutes
soup cron create health-check \
  --schedule "*/5 * * * *" \
  --url https://api.myapp.com/health

# List jobs
soup cron list

# View run history
soup cron runs daily-cleanup

# Manually trigger a job
soup cron trigger daily-cleanup

Cron Expressions

┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of week (0 - 6)
│ │ │ │ │
* * * * *

Examples:

0 0 * * * - Daily at midnight
*/15 * * * * - Every 15 minutes
0 9 * * 1-5 - Weekdays at 9am
0 0 1 * * - First day of each month

Webhook Request (Preview)

POST https://api.myapp.com/cleanup
Content-Type: application/json
X-Soup-Job-Id: job_abc123
X-Soup-Run-Id: run_xyz789

{
  "scheduled_at": "2024-01-15T00:00:00Z",
  "job_name": "daily-cleanup"
}

Pricing (Planned)

Tier	Limits
Free	10 jobs, 1,000 runs/month
Standard	Unlimited ($1/user/month)
Self-hosted	Unlimited (free)

Interested?

Sign up for early access to be notified when Cron is available.