TOC & Recently Viewed

Recently Viewed Topics

Add Asset Data to Tenable.io

User Permissions: Standard (32)

Scan Permissions: Can Configure (64)

You can use the Tenable.io API to import a list of assets in JSON format.

To add asset data to Tenable.io, use the API endpoint described below.

HTTP Request

Note: To authenticate your request, be sure to include API keys in the HTTP header of the request. For more information, see Authorization.

Caution: 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.

Request Path Syntax

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

Request Path Parameters

None.

Request Path Example

See "Request Path Syntax."

Request Body Syntax

{ "assets": [ {asset object}, {asset object}, {asset object} ], "source": {string} }

Request Body Attributes

Attribute Type Description Required?
assets array

An array of asset objects to import.

yes
source string

A user-defined name for the source of the asset records you want to import.

yes

Request Body Example

{ "assets": [ { "ipv4": [ { "172.204.81.57", "172.82.157.177" } ], "operating_system": [ { "Linux Kernel 2.6.32-71.el6.i686 on Red Hat Enterprise Linux Server release 6.0 (Santiago)" } ], "ssh_fingerprint": "423fa07b4a12f386149e09ea10021a89", "bios_uuid": "423ee0f1-0032-700c-afd7-a686d88da63e" ], "source": local_scan }

HTTP Response

Response Codes

Status Description
200 Returns the import job UUID. For more information, see "Response Body Syntax."
400 Returned if you submitted a bad request.
403 Returned if you do not have permission to import assets.
429

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

Response Body Syntax

{ "asset_import_job_uuid": {string} }

Response Body Attributes

Attribute Type Description
asset_import_job_uuid string The unique identifier for the import job. Use this value to query the status of the asset import job.

Response Body Example

{ "asset_import_job_uuid": "c25af9c0-8327-4af6-b9e5-d39b7f190e9b" }

Reference Guide

https://cloud.tenable.com/api#/resources/assets/import

Examples

Copyright © 2019 Tenable, Inc. All rights reserved. Tenable, Tenable.io, Tenable Network Security, Nessus, SecurityCenter, SecurityCenter Continuous View and Log Correlation Engine are registered trademarks of Tenable, Inc.. Tenable.sc, Lumin, Assure, and the Cyber Exposure Company are trademarks of Tenable, Inc. All other products or services are trademarks of their respective owners.