Scheduled scans

Automate recurring scans using cron expressions. Scheduled scans run automatically without manual intervention.

Create a schedule

bash

POST /api/v1/schedules
Authorization: Bearer <token>
X-Tenant-Slug: my-company
Content-Type: application/json

{
  "connection_id": "conn_abc123",
  "cron_expression": "0 6 * * *",
  "name": "Daily production scan",
  "enabled": true
}

json

{
  "id": "sched_111",
  "name": "Daily production scan",
  "connection_id": "conn_abc123",
  "cron_expression": "0 6 * * *",
  "enabled": true,
  "next_run_at": "2026-04-13T06:00:00Z"
}

Common cron expressions

0 6 * * *Daily at 6am UTC

0 6 * * 1Every Monday at 6am UTC

0 0 1 * *First day of every month

0 */6 * * *Every 6 hours

List schedules

bash

GET /api/v1/schedules
Authorization: Bearer <token>
X-Tenant-Slug: my-company

Pause a schedule

bash

PATCH /api/v1/schedules/sched_111
Content-Type: application/json

{"enabled": false}