Configure a schedule

Use Settings → Schedule to store schedule preferences for the current organization.

Required permission: schedule:manage. Administrators, Managers, and Scrum Masters receive it by default.

Save schedule settings#

1. Open Settings, expand it, and select Schedule.
2. Turn on Enable Scheduled Sync.
3. Select a Frequency.
4. Select the cycles to include.
5. Choose the board scope.
6. Review the displayed next-run estimate.
7. Select Save Settings.

Expected result: the page reports Schedule settings saved successfully.

Important runtime limitation#

The API stores schedule settings, but a durable scheduler still needs to invoke the automation. The repository’s authoritative hosted scheduler is GitHub Actions. The API’s in-process ticker is intentionally skipped on Vercel because serverless instances are not reliable long-running schedulers.

Saving this screen does not prove that a production schedule is firing. An operator must verify the external scheduler, its environment, and a recent successful run.

Verify a schedule#

1. Confirm the external scheduler is enabled.
2. Check the configured timezone and cron expression at the scheduler.
3. Wait for a scheduled execution or use an authorized manual dispatch.
4. Verify the terminal workflow result.
5. Confirm the resulting run or audit record appears where expected.

For self-hosted options, see Deployment and self-hosting.