Update network

put

https://cloud.tenable.com/networks/{network_id}

Updates the name or description of a network object.

Note: The name body parameter is required when updating the specified network with this endpoint. To retrieve the name, use the GET /networks/{network_id} endpoint.

Requires the Administrator [64] user role or the VM.VM_SENSOR.NETWORK.EDIT custom role privilege. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

network_id

string

required

The UUID of the network object you want to update. You cannot update the default network object.

Body Params

name

string

required

The new name of the network object. This name must be unique within your Tenable Vulnerability Management instance, cannot duplicate the name of a previously deleted network, and cannot be default.

description

string

The new description of the network object.

assets_ttl_days

integer

The number of days to wait before assets age out. Assets will be permanently deleted if they are not seen on a scan within the specified number of days.

Minimum value: 14
Maximum value: 365

Warning: If you enable this option, Tenable Vulnerability Management immediately deletes assets in the specified network that have not been seen for the specified number of days. All asset records and associated vulnerabilities are deleted and cannot be recovered. The deleted assets no longer count towards your license.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Returned if Tenable Vulnerability Management encounters invalid JSON in the request body, if you attempted to change the default network object, or if an invalid assets_ttl_days value was declared (min: 14, max: 365).

401

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

403

Returned if you do not have permission to update the specified network object.

404

Returned if Tenable Vulnerability Management could not find the specified network object, either because the object does not exist or because the object has been deleted.

409

Returned if a network object with the same name already exists.

415

Returned if the request payload is in an unsupported format.

200Returns successfully updated details of the network object.

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 encountered an internal server error. Wait a moment, and try your request again.

503Returned if a Tenable Vulnerability Management service is unavailable. Wait a moment, and try your request again.