AUTOMATE. BUILD. DELIVER.

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

Get Started    API Explorer

Import File Formats

Exclusion Import File

Using the POST /file/upload and POST /exclusions/import API endpoints, you can import exclusions as a comma-separated values (.csv) file for use in scan configuration in Tenable.io.

This file is composed of a header and at least one line of data. Each line in the file must be separated by a new line break.

Header (Optional)

A header line in the file is optional. If included, the header must be the first line in the file and be formatted as follows:

id,name,description,members,creation_date,last_modification_date

🛈

Note

There are no spaces after the commas in this line.

Data (Required)

Each data line in the file represents one exclusion configuration.

Each data line is a comma-delimited string of fields described in the table below.

🛈

Note

Optional fields can be blank, but the associated comma separator must be present in the data line.

FieldDescriptionRequired
idAn integer that uniquely identifies the exclusion.optional
nameThe name of the exclusion. You can use any combination of alpha-numeric characters or symbols.required
descriptionA description for the exclusion.required
membersThe target or targets where you want the scan exclusion to apply. This value can have the following formats:
  • A host name (example.com)
  • An IP address (172.204.81.57)
  • An IP range (172.204.81.57-172.204.81.67)
  • A comma-separated list of multiple host names, IP addresses, or IP ranges, bracketed by quotation marks ("172.204.81.57,172.82.157.177,172.156.65.8")
required
creation_dateThe Unix timestamp that Tenable.io uses as the creation date for the imported exclusion(s).optional
last_modification_dateThe Unix timestamp that Tenable.io uses as the last modification date for the exclusion(s).optional

Example

id,name,description,members,creation_date,last_modification_date
1,Exclusion Rule 1,routers,"172.204.81.57,172.82.157.177,172.156.65.8",1561643735,1561643785
,Exclusion Rule 2,workstations,172.204.81.57-172.204.81.67,,

Updated about a month ago


Import File Formats


Suggested Edits are limited on API Reference Pages

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