> ## Documentation Index
> Fetch the complete documentation index at: https://docs.major.build/llms.txt
> Use this file to discover all available pages before exploring further.

# Crons

> Schedule recurring tasks for your app.

Schedule recurring tasks for your app by defining them in a `cron.json` file in your repository. Each cron job includes:

* **Name** — a human-readable identifier
* **Schedule** — a cron expression (e.g., `"0 2 * * *"` for daily at 2 AM UTC)
* **URL** — the path in your app that gets called (e.g., `/api/cleanup`)
* **Description** — optional details about what the job does

## Managing Crons

The Crons panel in the editor shows all defined jobs with their schedules and execution history. You can:

* **View history** — see when each cron ran, how long it took, and whether it succeeded
* **Test manually** — click the Test button to run a cron job immediately (must be deployed first)
* **Edit jobs** — modify the name, schedule, or description
* **Delete jobs** — remove cron jobs from your app
* **View versions** — see cron definitions from different app versions and deploy specific versions

## Execution

When a cron executes, Major sends an HTTP POST request to the specified URL with an `x-major-cron-jwt` header containing a signed token. Use this to verify the request came from Major.