convex-cron-jobs

Create a convex/crons.ts file, call cronJobs() from convex/server, then register jobs with crons.interval for fixed periods or crons.cron for cron expressions. Each job references an internal function and optional static arguments.

Use crons.cron with a cron expression like "0 9 * * *" to run daily at 9 AM. All cron expressions in Convex are interpreted in UTC, so convert your local target time accordingly.

Cron jobs should call internal functions only, not public ones. Define the work as an internalMutation or internalAction and reference it through the internal object imported from _generated/api.

Process records in batches using paginate with a cursor, then schedule the next batch with ctx.scheduler.runAfter passing the continueCursor. This prevents long-running mutations from timing out.

Yes, but external calls must run in an internalAction with the "use node" directive, since mutations cannot make network requests. Fetch the data in the action, then persist it via ctx.runMutation.

Convex cron expressions always use UTC. A common pitfall is writing expressions in local time, so convert your desired schedule to UTC before registering the job.