Tenable.io: Force Stop Scan

A new endpoint has been added to the Tenable.io API to allow customers to force stop a scan. A force stop aborts all the scan's tasks and updates the scan status to aborted. You can only force stop a scan that has a status of stopping or publishing. For more information about scan statuses, see Scan Status.

The endpoint accepts a string path parameter called schedule_uuid, which specifies the scan that you want to force stop. You can find a scan's schedule_uuid in the GET /scans endpoint's response message.

The new endpoint is described in the following table:

Endpoint	Name	Description
POST /scans/{schedule_uuid}/force-stop	Force stop scan	Force stops a scan. You can only force stop a Nessus scanner scan that has a status of `stopping` or `publishing`.

Example

For example, to force stop a scan with a schedule_uuid of template-0fza2e71-89e3-1zb5-37z3-9ebfe535715a148f9z143521z99f in your container, you could use the following cURL request:

curl --request POST \
     --url 'https://cloud.tenable.com/scans/template-0fza2e71-89e3-1zb5-37z3-9ebfe535715a148f9z143521z99f/force-stop' \
     --header 'X-ApiKeys: accessKey=<YOURKEY>;secretKey=<YOURKEY>' \
     --header 'accept: application/json'