# Automated Cron Scheduler REST APIs

> Schedule recurring tasks, pause/resume workers, trigger immediate manual runs, and inspect execution logs.

**Category:** REST API Reference  
**URL:** https://docs.botlify.cloud/api-crons  
**Platform:** Botlify Cloud (https://botlify.cloud)  

---

## 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. |