Schedule a boost

Use cron expressions to run a boost automatically on a recurring schedule.

Boosts can run on a schedule using standard cron expressions. Set the schedule field when creating or updating a boost.

Cron expression format

┌─ minute (0–59)
│ ┌─ hour (0–23)
│ │ ┌─ day of month (1–31)
│ │ │ ┌─ month (1–12)
│ │ │ │ ┌─ day of week (0–7, 0 and 7 = Sunday)
│ │ │ │ │
* * * * *

Common schedules

Schedule	Cron
Every hour	`0 * * * *`
Every day at 2 AM UTC	`0 2 * * *`
Every Monday at 8 AM UTC	`0 8 * * 1`
Every 6 hours	`0 /6 * *`

Set a schedule via the API

Include schedule in the request body when creating or updating a boost:

curl -X POST https://api.cache-boost.com/v1/sites/42/boosts \
  -H "Authorization: Bearer cb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Nightly warm",
    "source": "sitemap",
    "concurrency": 3,
    "schedule": "0 3 * * *"
  }'

To remove a schedule, set "schedule": null via PATCH.

All schedule times are in UTC.

On-demand runs

A scheduled boost can also be triggered manually at any time via POST /v1/sites/{siteId}/boosts/{boostId}/run. Manual runs don't affect the next scheduled run.