DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer

Delete scan history

delete
https://cloud.tenable.com/scans//history/

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
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.

uuid
required

The unique identifier of the historical data that you want Tenable Vulnerability Management to delete. This identifier corresponds to the history.scan_uuid attribute of the response message from the GET scan history endpoint.

Query Params
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.

Updated about 2 months ago

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

Updated about 2 months ago