# Create and delete scan schedules

Scans Schedules API

Create a scan schedule

A new endpoint is available to create scan schedules: recurring scans that run on a set timetable.

Endpoint: POST /v1/scans/schedules/

The request accepts the following fields:

• name — A name for the schedule.
• schedule_period — How often the scan runs. One of: daily, weekly, monthly, or quarterly.
• targets (optional) — A list of target IDs to include in the scan. If omitted, the schedule applies to all targets.
• tags (optional) — A list of tag names to scope the scan to targets with those tags.
• throttled (optional) — Set to true to run the scan at a reduced speed to minimise impact on target systems. Defaults to false.
• web_ports_only (optional) — Set to true to limit the scan to web ports (80, 443, etc.) for a faster, more focused scan. Defaults to false.
• upload_to_drata / upload_to_vanta (optional) - Set to true to automatically upload results to Drata or Vanta. Defaults to false.

Delete a scan schedule

A new endpoint is available to delete scan schedules.

Endpoint: DELETE /v1/scans/schedules/{id}/

Permanently removes the scan schedule with the given ID. Returns a 204 No Content response on success.

For more information, see the API documentation for scans.