Reference
willo_schedule_job
Run one of the business's Edge Functions on a schedule (cron, UTC).
- Act
- Needs approval
- Secret scan
- Metered
On this page
Schedule a backend job. Always the LIVE backend — jobs never run on a draft — and every run bills backend time. A function deployed with verify_jwt gets a backend session; a public one gets no credential unless auth_secret names the secret it checks. ALWAYS needs a person's approval; the card shows the projected monthly cost.
Access
- Token: read + act, and editor access or higher on the business.
- Approval: Always. Every call raises a card a person approves on the dashboard.
- Secret scan: refused if the new content holds a value shaped like an API key or token.
- Metered: counts toward a per-business, per-minute limit for this kind of call. See Limits.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Job name (lowercase letters, digits and -). |
schedule | string | yes | Cron expression in UTC, e.g. 0 9 * * 1. |
function | string | yes | The Edge Function slug to call. |
body | object | no | Optional JSON body sent on each run. Never a credential. |
auth_secret | string | no | Optional name of a function secret already set on the business (never its value), sent on every run for a public function that checks it. SUPABASE_SERVICE_ROLE_KEY sends the service-role key. |
auth_header | string | no | Header carrying auth_secret: default Authorization (as Bearer <value>); any other header, e.g. x-cron-secret, gets the bare value. |