Automated Cron Scheduler REST APIs
Schedule recurring tasks, pause/resume workers, trigger immediate manual runs, and inspect execution logs.
Cron Actions in api/v1
Automate background workers (e.g. daily resets, subscription checks, database cleanups) down to 1-minute intervals:
| Action | Parameters | Description |
|---|---|---|
list_crons |
bot_id |
Returns array of cron jobs with schedule string, active status, last execution, and logs. |
create_cron |
bot_id, name, schedule, command |
Creates a recurring background worker. Schedule accepts standard 5-part cron syntax (e.g. */15 * * * *). |
toggle_cron |
bot_id, cron_id |
Pauses or resumes an active cron worker without deleting it. |
run_cron |
bot_id, cron_id |
Immediate Manual Trigger: Executes the cron job immediately and returns stdout/stderr logs. |
delete_cron |
bot_id, cron_id |
Permanently deletes the scheduled cron worker. |