Scheduled jobs

Create a scheduled job

1. Open Functions and select New function, then choose the Scheduled job template.
2. Write the work the job should do.
3. In the Triggers tab, keep Cron schedule selected and choose a preset (Every minute, Hourly, Daily, Weekly) or type your own expression.
4. Save the function and use Run function now once to check the result.
5. Open Scheduled jobs in the Project menu to confirm the job is registered.

Cron expressions

An expression has five parts: minute, hour, day of month, month, and day of week. Times use UTC.

Example: nightly cleanup

// Trigger: Cron schedule, 0 3 * * *
$db.execute(
  "DELETE FROM sessions WHERE expires_at < now() - interval '7 days'",
  {},
);
console.log("cleanup finished", $utils.now());
({ done: true })

List and run jobs from a server

const jobs = await rb.admin.crons.list();   // [{ id, expression }]
await rb.admin.crons.run(jobs[0].id);       // runs it now

Operate safely

• Make each run idempotent, so running it twice gives the same result.
• Process work in small batches and keep each run under the function timeout.
• Avoid scheduling a job more often than it takes to finish.
• Log what each run did, then check the function's Logs tab after the first few runs.
• Pause the function to stop the schedule without losing the code.