Scheduled Scans

Note: Scan scheduling stores your configuration. For automatic scan execution, use our CI/CD integration templates.

Configure SCA scan schedules so your dependency data stays current. Scans run automatically based on your configured schedule.

Creating a Schedule

1. Navigate to SCA > Schedule for the target repository.
2. Click New Schedule.
3. Choose a preset frequency or provide a custom cron expression.
4. Select the branch to scan (defaults to the repository’s default branch).
5. Click Save. The next run date is calculated immediately and displayed.

Frequency Options

Cron Expression Format

Cron expressions use five fields separated by spaces:

minute  hour  day_of_month  month  day_of_week
  0       2       *            *        *

• minute — 0-59
• hour — 0-23
• day_of_month — 1-31
• month — 1-12
• day_of_week — 0-6 (0 = Sunday)

Use * for any value, */N for intervals, and 1,3,5 for specific values.

Viewing Schedules

The SCA > Schedule page lists all schedules across your repositories. Each entry shows:

• Repository name and branch
• Frequency label and raw cron expression
• Next calculated run date
• Last run date and status (once automatic execution is enabled)

Next Run Calculation

When a schedule is created or updated, the server calculates the next run date from the current UTC time using the cron expression. The scheduler checks for due scans every 5 minutes and triggers them automatically.

Enable and Disable

Toggle a schedule on or off without deleting it. Disabled schedules retain their configuration. Re-enabling a schedule recalculates the next run date from the current time.

PATCH /api/sca/schedules/{schedule_id}
{
  "enabled": false
}

Permissions

Only users with the ORG_ADMIN or ORG_OWNER role can create, modify, or delete scan schedules. Members and viewers can view existing schedules and their results.