Delete scan history

delete

https://cloud.tenable.com/scans/{scan_id}/history/{history_id}

Deletes historical results from a scan. Note that rollover scan data is also deleted.

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

Path Params

scan_id

string

required

The unique identifier for the scan. This identifier can be either the scans.schedule_uuid or the scans.id attribute in the response message from the GET /scans endpoint. Tenable recommends that you use scans.schedule_uuid.

history_id

int32

required

The unique identifier of the historical data that you want Tenable Vulnerability Management to delete. This identifier corresponds to the history.id attribute of the response message from the GET /scans/{scan_id}/history endpoint.

Query Params

delete_rollovers

boolean

Indicates whether or not to delete scan rollover history. If true, the scan history and its associated rollover scan data are deleted. If false or null and the scan has rollover data, you receive a 409 error: "This scan contains rollover scan data. If you want to delete it and all the associated rollover scan data, use query parameter delete_rollovers=true."

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 results.

Language

Credentials

Header

Request

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

200Returned if Tenable Vulnerability Management successfully deleted the specified scan results.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if Tenable Vulnerability Management fails to delete the scan results.

501Returned if Tenable Vulnerability Management does not support deleting historical scan results.