Schedule & Webhooks
The Schedule tab lets you configure recurring Swarm QA scans and receive notifications when results are ready — or when critical findings demand immediate attention.
Scheduling Recurring Scans
Set up a scan to run automatically at fixed intervals:
| Option | Interval |
|---|---|
| Continuous | Every 30 minutes |
| Hourly | Every 60 minutes |
| Every 4 hours | Every 4 hours |
| Twice daily | Every 12 hours |
| Daily | Every 24 hours |
For each schedule, configure:
- Target URL — the entry point for the scan.
- Preset — Quick Smoke, Standard Scan, Deep Audit, or a custom Expert Mode configuration.
- Auto-refresh — when enabled, the Live tab automatically switches to the running scan.
INFO
Scheduled scans run in the background even when the Swarm QA page is not open. Results appear in the History tab when complete. The app must be running for schedules to execute.
Webhook Configuration
Webhooks notify external services when a scan completes. Configure them in the Schedule tab under Notifications.
Supported Platforms
| Platform | Payload format | Setup |
|---|---|---|
| Slack | Slack Block Kit message | Incoming webhook URL |
| Microsoft Teams | Adaptive Card | Incoming webhook URL |
| Discord | Discord embed | Webhook URL |
| Generic JSON | Raw JSON payload | Any HTTP endpoint |
Payload Content
Every webhook payload includes:
{
"target": "https://staging.example.com",
"score": 81,
"previousScore": 72,
"delta": "+9",
"findings": {
"critical": 0,
"high": 3,
"medium": 10,
"low": 5
},
"duration": "2m 34s",
"runUrl": "xyva://swarm/run/2026-03-21T10-00-00"
}Alert Conditions
Configure when webhooks fire:
| Condition | Description |
|---|---|
| Always | Send on every completed scan |
| Score threshold | Send only when score drops below a value (e.g., below 70) |
| Fix-now alert | Send immediately when any Critical or fix-now finding is detected |
| Score regression | Send when score drops by more than N points from previous run |
TIP
For production monitoring, use the fix-now alert condition to get instant Slack notifications when critical issues are detected, without noise from routine scans.
Test Button
Click Test Webhook to send a sample payload to your configured endpoint. This verifies the URL is reachable and the integration is working before relying on it for real alerts.
WARNING
Webhook URLs often contain secrets. They are stored locally in the project configuration and never transmitted to xyva's servers or LLM providers.