Cron jobs for Hono

Create a protected route

app.post("/api/tasks", async (c) => {
  if (c.req.header("x-schedule-secret") !== process.env.SCHEDULE_SECRET) {
    return c.text("Unauthorized", 401);
  }
  return c.json({ ok: true });
});

Set the secret, then deploy.

npx ezhst env set SCHEDULE_SECRET=<long-random-value>
npx ezhst deploy

Create the schedule

This calls the route once a day.

npx ezhst schedules create nightly \
  --url https://<app-slug>.easyhost.fun/api/tasks \
  --every 1440 \
  --method POST \
  --headers '{"x-schedule-secret":"<long-random-value>"}'

How schedules behave

• Requests time out after 30 seconds, so hand long work to a queue or split it up
• Redirects are not followed, so use the final URL
• Missed intervals are skipped after downtime, and calls to one schedule do not overlap
• A project can have five schedules, and the latest 100 runs are retained

npx ezhst schedules logs <id>

See the Hono hub for every Hono guide, or free Hono hosting for what is included. See also the schedules product page.

Frequently asked questions

What is the shortest interval?

One minute. The longest is 43200 minutes, which is 30 days.

Start for free

Install the skill, choose Global or Local, then tell your agent to deploy. No credit card, no config files.

npx ezhst skill install