Bulk delete assets

post

https://cloud.tenable.com/api/v2/assets/bulk-jobs/delete

Deletes the specified assets. This request creates an asynchronous delete job in Tenable Vulnerability Management.

For information about the assets bulk delete workflow and payload examples, see Bulk Asset Operations.

Requires the Scan Operator [24] user role. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

hard_delete

boolean

Defaults to false

Indicates whether or not to hard delete the specified assets.

Caution: Deleting assets completely removes the assets from your licensed asset count along with all related data and the deleted assets are not available for restoration. This occurs whether hard_delete is set to true or false.

When hard_delete is set to true, deleted assets are no longer visible in the user interface or available through the API. When hard_delete is set to false, deleted assets can only be retrieved via the API using a direct asset UUID, and are available for export via the API for 90 days. The primary goal of setting hard_delete to false is to reflect those deletions through integrations.

If this parameter is omitted, Tenable Vulnerability Management uses the default value of false.

query

required

The query filters for selecting assets to delete. The format for a single query filter is different from the format for multiple query filters so you must select one or the other.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Returned if your request specified invalid parameters or if your request was improperly formatted. For example, if you specify an invalid asset query using a malformed IPv4 address.

403

Returned if you do not have permission to bulk delete assets.

503

Returned if Tenable Vulnerability Management is unavailable or not ready to process the request. Wait a moment and try your request again.

202Returned if Tenable Vulnerability Management successfully deleted the requested assets.

401Returned if the API keys specified in your request are invalid.

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

500Returned if an internal error occurred in Tenable Vulnerability Management.