---
title: "Scan Status"
method: POST
path: "/api/3/scans/{id}/{status}"
tags: ["Scan"]
---

# Scan Status

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

Updates the scan status. Can pause, resume, and stop scans using this resource. In order to stop a scan the scan must be running or paused. In order to resume a scan the scan must be paused. In order to pause a scan the scan must be running.

## Path parameters

- `id` integer, required — The identifier of the scan.
- `status` 'pause' | 'stop' | 'resume', required

## 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)