Delete network

Deletes the specified network object. Before you delete a network object, consider moving assets to a different network using the bulk asset move endpoint (POST /api/v2/assets/bulk-jobs/move-to-network). If you delete a network object, Tenable Vulnerability Management:

  • Returns the scanners and scanner groups associated with the deleted object to the default network object.
  • Retains any asset records for the deleted network until the assets age out of your licensed assets count.

Note: You can view deleted network objects using the includeDeleted filter in a GET /networks request.

Requires the Administrator [64] user role. See Roles.

Path Params
string
required

UUID for the network object you want to delete. You cannot delete the default network object.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

400

Returned if you attempted to delete the default network object.

401

Returned if Tenable Vulnerability Management cannot authenticate the user account that submitted the request.

403

Returned if you do not have sufficient permissions to delete the specified network object.

404

Returned if Tenable Vulnerability Management could not find the network object you specified.

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