DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer

Create exclusion

post
https://cloud.tenable.com/exclusions

Creates a new exclusion.

Requires the Scan Manager [40] user role or the VM.VM_SCAN.VM_SCAN_EXCLUSION.CREATE custom role privilege. See Roles.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The name of the exclusion.

string

The description of the exclusion.

string
required

The targets that you want excluded from scans. Specify multiple targets as a comma-separated string. Targets can be in the following formats:

  • An individual IPv4 address (192.0.2.1)
  • A range of IPv4 addresses (192.0.2.1-192.0.2.255)
  • CIDR notation (192.0.2.0/24)
  • A fully-qualified domain name (FQDN) (host.domain.com)
schedule
object

The schedule parameters for the exclusion. When enabled is false (Always On), only the enabled field is returned.

string

The ID of the network object associated with scanners where Tenable Vulnerability Management applies the exclusion. The default network ID is 00000000-0000-0000-0000-000000000000. To determine the ID of a custom network, use the GET /networks endpoint. For more information about network objects, see Manage Networks.

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 create an exclusion. For more information, see Roles and Permissions.

Updated 2 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html

Updated 2 months ago