Force stop scan

Force stops a scan. A force stop cancels all the scan's incomplete scan tasks and updates the scan status to aborted. Tenable Vulnerability Management processes and indexes the completed scan tasks. After you force stop a scan, Tenable recommends re-running the scan in its entirety to ensure total scan coverage.

You can use the force stop endpoint to abort a stalled scan in the stopping, publishing, or resuming status. This can be helpful when you need to abort a scan before a freeze window or before a subsequent scheduled scan begins.

You can only force stop a scan that has a status of stopping or publishing. For more information about scan statuses, see Scan Status.

Requires the Scan Operator [24] user role and Can Execute [32] scan permissions. See Roles and Permissions.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The identifier for the scan you want to force stop. For the identifier, use the scans.schedule_uuid in the GET /scans endpoint's response message.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

404

Returned if Tenable Vulnerability Management cannot find the specified scan.

409

Returned if the scan does not have a stopping, or publishing status. For more information about scan statuses, see Scan Status.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html