Import assets

post

https://cloud.tenable.com/import/assets

Imports asset data in JSON format.

The request size cannot exceed 5 MB. For example, if the average asset record you want to import is about 2 KB, you can import approximately 2,500 assets in a single request.

Note: This endpoint does not support the network_id attribute in asset objects for import. Tenable Vulnerability Management automatically assigns imported assets to the default network object. For more information about network objects, see Manage Networks.

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

assets

array of objects

required

An array of asset objects to import. Each asset object requires a value for at least one of the following properties: fqdn, ipv4, netbios_name, mac_address.

For an example of this request body, see Add Asset Data to Vulnerability Management. For the complete list of importable asset attributes, see Common Asset Attributes.

Caution: AWS, Azure, and GCP asset data must be imported separately even if the data is associated with the same asset. For example, Azure imports should only contain Azure data in the payload. The import fails if AWS data is included with the Azure data in the payload.

assets*

source

string

required

A user-defined name for the source of the import containing the asset records. You can specify only one source for each import.

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.

403

Returned if you do not have permission to import assets.

200Returned if Tenable Vulnerability Management successfully queued the import job.

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.