---
title: "Site Scans"
method: POST
path: "/api/3/sites/{id}/scans"
tags: ["Scan"]
---

# Site Scans

`POST /api/3/sites/{id}/scans`

Starts a scan for the specified site.

## Path parameters

- `id` integer, required — The identifier of the site.

## Query parameters

- `overrideBlackout` boolean

## Request body

- AdhocScan — The details for the scan.
  - `assetGroupIds` object[] — The asset groups that should be included as a part of the scan. Only asset groups assigned to the site can be specified for a scan. This value should be an array of integers representing the unique identifiers of the asset groups.
  - `engineId` integer — The identifier of the scan engine.
  - `hosts` string[] — The hosts that should be included as a part of the scan. This should be a mixture of IP Addresses and Hostnames as a String array.
  - `name` string — The user-driven scan name for the scan.
  - `templateId` string — The identifier of the scan template

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/rapid7/apis/rapid7-vm-api.md) · [All operations](https://skmtc.net/rapid7/apis/rapid7-vm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapid7/rapid7-vm-api/versions/3a8197c22d71/schema)