Scheduling recurring audits

A scheduled audit runs automatically on a cadence and notifies you when something changes. This is how you catch regressions before they cost you traffic.

Create a schedule

1. Open any past audit report.
2. Menu (three dots, top-right) → Schedule recurring.
3. Pick cadence: weekly, monthly or custom (cron).
4. Pick day + time. Defaults to workspace timezone.
5. Pick notification destination: email, Slack channel, webhook.
6. Optionally tick "Only notify on regression".
7. Save.

Cron syntax (custom cadence)

Five-field standard cron, no seconds. Examples:

text
0 9 * * 1     Every Monday at 9am
0 9 * * 1,4   Every Monday and Thursday at 9am
0 */6 * * *   Every 6 hours
0 9 1 * *     The 1st of every month at 9am

Cron parsing uses standard Unix semantics. We don't support seconds, year fields, or @reboot-style aliases.

Notification destinations

Regression-only mode

When enabled, you only get notified when the SEO score drops by more than 3 points OR a new critical issue appears. Cuts noise to near-zero on stable sites.

Multiple schedules per site

You can stack schedules on one site. Common pattern:

• Daily lightweight audit (depth 2, homepage only) for fast-regression detection.
• Weekly full audit (depth 5, full sitemap) for comprehensive view.
• Monthly deep audit (depth unlimited, with external links) for completeness.

Schedule API

bash
curl -X POST https://api.semoptimiser.com/v1/audit-schedules \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "site_1",
    "cron": "0 9 * * 1",
    "depth": 5,
    "notify": ["email:you@example.com", "slack:#seo"],
    "regression_only": true
  }'

Pause / resume

Audits → Scheduled → toggle pause. Paused schedules keep their config and history but don't fire new audits. Resume from the same screen.