AUTOMATE. BUILD. DELIVER.

Integrate with the world's first Cyber Exposure platform using Tenable APIs

Get Started    API Explorer

Add Asset Data to Tenable.io

Add asset data into Tenable.io using the POST /import/assets endpoint. This endpoint allows you to import a list of assets in JSON format. For the complete list of importable asset attributes, see Common Asset Attributes.

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 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",
      "installed_software": [
        "cpe:/a:apple:itunes:12.8",
        "cpe:/a:apple:quicktime:7.7.3",
        "cpe:/a:openbsd:openssh:6.9",
      ]
    },
    {
      "mac_address": [
        "00-00-5E-00-53-00",
        "00-00-5E-00-53-FF" ],
      "netbios_name": "COMPUTERNAME1", 
      "fqdn": [
        "example.com"
      ],
      "installed_software": [
        "cpe:/a:apple:itunes:12.8",
        "cpe:/a:apple:quicktime:7.7.3",
        "cpe:/a:openbsd:openssh:6.9",
        "cpe:/a:google:chrome"        
      ]
    }    
  ],
    "source": "local_scan"
}

Examples


Add Asset Data to Tenable.io


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.