CLICommands
jobs
snug jobs <COMMAND>Manage jobs (schedule, cancel, list).
Subcommands
| Command | What it does |
|---|---|
list | List jobs with filters |
info | Show detailed job information |
schedule | Schedule a new job |
cancel | Cancel a scheduled job |
cancel-all | Bulk-cancel your scheduled jobs (emergency kill switch). Targets jobs in the scheduled state, including jobs parked between retry attempts |
admin-cancel-all | Admin: bulk-cancel scheduled jobs across users (global kill switch, requires the admin role) |
schedule-batch | Schedule multiple jobs in batch |
cleanup | Admin: prune old terminal jobs past the configured retention window (requires the admin role) |
Run snug jobs <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug jobs list --queue email --status scheduled --limit 50
snug jobs info job_123
snug jobs schedule --webhook-url https://example.com/hook --delay 30 --queue critical --priority high --payload '{\"order_id\":123}'
snug jobs cancel job_123
# 'default' is the only built-in queue; other names are custom queues
# created with 'snug job-queues create'
snug jobs cancel-all --queue default --force
snug jobs cancel-all --min-attempts 2 --force
# global kill switch across every user (admin token required)
snug jobs admin-cancel-all --force
snug jobs admin-cancel-all --user user_123 --queue default --force
snug jobs schedule-batch -f jobs.json
# admin: prune old terminal jobs past the configured retention window
snug jobs cleanup --forceNext
- job-queue guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.