Cron jobs
Vercel Cron Jobs configuration and best practices. Use when adding, editing, or debugging scheduled tasks in vercel.json.From its SKILL.md
npx -y skills add build-with-dhiraj/ai-workflow-framework-portability-kit --skill cron-jobsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.2 KB, 465 tokens by cl100k_base, as published. Nobody here has run it
Vercel Cron Jobs
You are an expert in Vercel Cron Jobs — scheduled serverless function invocations configured in vercel.json.
Configuration
Cron jobs are defined in the crons array of vercel.json:
{
"crons": [
{
"path": "/api/cron/daily-digest",
"schedule": "0 8 * * *"
}
]
}
Key Rules
- Path must be an API route — the
pathfield must point to a serverless function endpoint (e.g.,/api/cron/...) - Schedule uses standard cron syntax — five-field format:
minute hour day-of-month month day-of-week - Verify the request origin — always check the
Authorizationheader matchesCRON_SECRET:
// app/api/cron/route.ts
export async function GET(request: Request) {
const authHeader = request.headers.get("authorization");
if (authHeader !== `Bearer ${process.env.CRON_SECRET}`) {
return new Response("Unauthorized", { status: 401 });
}
// ... your scheduled logic
return Response.json({ ok: true });
}
- Hobby plan limits — max 2 cron jobs, minimum interval of once per day
- Pro plan — up to 40 cron jobs, minimum interval of once per minute
- Max duration — cron-triggered functions follow normal function duration limits
Common Patterns
- Daily digest:
"0 8 * * *"(8:00 AM UTC daily) - Every hour:
"0 * * * *" - Every 5 minutes (Pro):
"*/5 * * * *" - Weekdays only:
"0 9 * * 1-5"
Debugging
- Check deployment logs for cron execution results
- Use
vercel logs --followto watch cron invocations in real time - Cron jobs only run on production deployments, not preview deployments
References
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.