- Read: 5 min
- Updated: Jul 10, 2026
- Audience: Workspace owners
§ 01 What scheduled scans are
A workspace schedule can start a recurring scan, recurring fix reviews of eligible public findings, or both. Instead of starting each run by hand, you set one cadence and choose which actions Apex should trigger using the workspace scope and context you already configured. Scheduled runs appear in the workspace alongside manual scans and fix reviews, so there is no separate place to look for their results.Key idea Scheduling is best for a coherent, long-lived workspace you want to keep watching over time. Scope and context still come from the workspace, so keep them accurate.
§ 02 Why schedule scans
- Keep monitoring a workspace continuously instead of remembering to start each scan by hand.
- Catch regressions and newly introduced issues automatically as the code keeps changing.
- Recheck eligible public findings across the workspace scan history without starting each fix review by hand.
- Keep findings fresh on long-lived systems where the security surface shifts over time.
§ 03 Enable a schedule
Scheduling is configured from the workspace scan list. The steps below walk through turning it on.- Open the workspace - Go to the workspace you want to monitor and stay on the scan list view.
- Open the schedule dialog - Select Schedule in the scan list header to open the Auto-trigger scans dialog.
- Choose what to schedule - Enable Auto-trigger scan, Auto-trigger fix review, or both. For fix reviews, choose whether each repository should use its workspace/default branch or the same named branch override.
- Choose a cadence - Set the interval with Every and a number, then pick Days or Weeks. Weekly schedules also let you choose the day of the week the schedule runs.
- Save the schedule - Select Save schedule. Apex records the schedule and shows the next run date.
Fix review scope and branches Scheduled fix reviews preflight public findings from every non-archived, non-fix-review scan in the workspace, then start only the eligible reviews. They are not limited to the latest scan. Workspace branch lets each repository use its default or configured workspace branch. A named branch override is applied to every repository in the workspace, so use it only when that branch exists across the repository set.
§ 04 Choosing a cadence
The interval is an Every value paired with a unit. Pick the granularity that matches how often the workspace changes.- Days: run every N days, up to 365.
- Weeks: run every N weeks, up to 52, on a chosen day of the week.
- The enabled scan and fix-review actions share the same cadence.
- The dialog summarizes the schedule (for example, “Every 2 weeks on Mon”) and shows the next run date.
First run After you save, Apex evaluates each enabled action at the next scheduled time. A scheduled fix review preflights existing public findings in the workspace scan history using the selected branch behavior; it does not create a new workspace scan first.