Tenable Vulnerability Management

App · 25 actions

Run and manage Tenable vulnerability scans, find assets and vulnerabilities, export findings and scan reports, tag assets, and start workflows when scans finish or fail, new critical vulnerabilities or assets appear, or vulnerabilities are fixed.

Actions

ActionWhat it does
Create scanCreate a scan of the given targets (addresses, ranges or host names) from a Tenable scan template, Basic Network Scan unless another is chosen.
Create tagCreate a tag value in a category, such as Seattle in Location.
Delete scanDelete a scan and its results.
Delete tagDelete a tag value, which also takes it off every asset.
Export scan resultsExport a scan's results as a file (CSV, Nessus, HTML or PDF) a later step can attach or upload.
Export vulnerabilitiesGet every finding (one vulnerability on one asset, with the plugin's details, CVEs and fix) matching the filters, through Tenable's export.
Get assetGet one asset with its addresses, host names, operating system, tags, sources and when it was first and last seen.
Get pluginGet a plugin (one of Tenable's vulnerability checks) with its family, synopsis, description, solution and risk factor.
Get scan resultsGet a scan's latest run (or one past run): its status and times, each host with its count of findings by severity, and the findings grouped by plugin.
Launch scanStart a scan now, optionally on other targets for this run only.
List agentsList linked Tenable agents with their platform, IP address, status, health, groups and when they last connected.
List assetsList or search assets (hosts and devices Tenable has seen) with their addresses, names, operating system and exposure score.
List audit log eventsList audit log events, newest first: who did what (sign-ins, changes to users, scans and settings), to what, and whether it failed.
List exclusionsList exclusions: the hosts, ranges and times scans must leave alone, with their schedules.
List scan runsList a scan's past runs, newest first, with each run's status and when it started and finished.
List scannersList the scanners and scanner groups you can scan with, including Tenable's cloud scanners, with their status.
List scansList the scans you can see with their status (completed, running, aborted and so on) and when they last ran, optionally in one folder, by status, by name or by when they last started.
List tag categoriesList the tag categories (such as Location or Owner) used to tag assets.
List tagsList tags (each a category and value, such as Location: Seattle) with their UUIDs.
List usersList the account's users with their email, role level and whether they can sign in.
List vulnerabilitiesList vulnerabilities grouped by plugin, with how many times each was found, across every asset or on one asset, optionally only some severities.
Pause scanPause a running scan.
Resume scanResume a paused scan from where it stopped.
Stop scanStop a pending, running or paused scan.
Tag assetsAdd a tag to one or more assets, or take it off them.

Create scan

Create a scan of the given targets (addresses, ranges or host names) from a Tenable scan template, Basic Network Scan unless another is chosen. It isn't started: use 'Launch scan'.

Inputs

NamenametextRequired
The scan's name.
TargetstargetslistRequired
What to scan: IP addresses, ranges (192.0.2.1-192.0.2.20), CIDR blocks or host names.
Templatetemplatetext
The scan template. Pick one, or type its name such as basic. Defaults to Basic Network Scan.
Scannerscanner_idtext
The scanner to use. Defaults to Tenable's cloud scanner.
Folderfolder_idtext
The folder to keep the scan in. Defaults to My Scans.
Descriptiondescriptiontext
A description of the scan.
Email when finishedemailslist
Addresses Tenable emails when a run finishes.

Outputs

scanobject
The new scan
Example output
{
  "scan": {
    "creation_date": 1765069990,
    "description": "Scan the web servers.",
    "emails": "security@example.com",
    "enabled": false,
    "id": 26,
    "last_modification_date": 1765069990,
    "name": "Weekly servers",
    "owner": "jo@example.com",
    "policy_id": 16,
    "scanner_uuid": "00000000-0000-0000-0000-00000000000000000000000000001",
    "type": "public",
    "uuid": "template-8b64a4a8-50b4-4077-bcc4-31f451fa3549f4f660ba792e0b0f"
  }
}

Create tag

Create a tag value in a category, such as Seattle in Location. A category that doesn't exist yet is created too.

Inputs

CategorycategorytextRequired
The category. Pick one, or type a new one.
ValuevaluetextRequired
The tag's value, up to 50 characters, with no commas.
Descriptiondescriptiontext
What the tag means.

Outputs

tagobject
The new tag
Example output
{
  "tag": {
    "category_description": "Where the asset is",
    "category_name": "Location",
    "category_uuid": "e50a526c-966f-4b80-a641-6dd359b8202e",
    "created_at": "2025-12-31T15:39:16.687Z",
    "created_by": "jo@example.com",
    "description": "Seattle office",
    "type": "static",
    "updated_at": "2025-12-31T15:39:16.687Z",
    "uuid": "76252c75-3f15-4258-82f5-6e5faed7f54a",
    "value": "Seattle"
  }
}

Delete scan

Delete a scan and its results. A running scan must be stopped first.

Inputs

Scanscan_idtextRequired
The scan. Pick one, or give its id or schedule UUID from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
scan_idtext
The scan's id
Example output
{
  "deleted": true,
  "scan_id": "32"
}

Delete tag

Delete a tag value, which also takes it off every asset. Its category is kept.

Inputs

Tagtag_idtextRequired
The tag (a category and value pair). Pick one, or give its UUID.

Outputs

deletedtrue/false
Always true once deleted
tag_idtext
The tag deleted
Example output
{
  "deleted": true,
  "tag_id": "76252c75-3f15-4258-82f5-6e5faed7f54a"
}

Export scan results

Export a scan's results as a file (CSV, Nessus, HTML or PDF) a later step can attach or upload. Waits while Tenable prepares it.

Inputs

Scanscan_idtextRequired
The scan. Pick one, or give its id or schedule UUID from an earlier step.
Formatfile_formattext
The kind of file. Defaults to CSV.One of: csv (CSV spreadsheet), nessus (Nessus file (XML)), html (HTML report), pdf (PDF report). Default: csv.
Run IDhistory_idnumber
One past run of the scan, its id from 'List scan runs'. Leave empty for the latest run.At least 1.
Report sectionschapterslist
For an HTML or PDF report, the sections to include. Defaults to the summary of hosts.Only when Format is HTML report or PDF report. One or more of: vuln_hosts_summary (Summary of hosts), vuln_by_host (Vulnerabilities by host), vuln_by_plugin (Vulnerabilities by plugin), remediations, compliance_exec (Compliance summary), compliance (Compliance details).

Outputs

fileobject
The saved file
file_formattext
csv, nessus, html or pdf
file_idtext
Tenable's id for the export
scan_idtext
The scan's id
Example output
{
  "file": {
    "content_type": "text/csv",
    "document_ref": "doc_0123456789abcdef0123456789abcdef",
    "filename": "tenable-scan-32.csv",
    "size_bytes": 20480,
    "url": "/actions/core/serve-document/doc_0123456789abcdef0123456789abcdef"
  },
  "file_format": "csv",
  "file_id": "SSEUF-ee904e9c-4fb6-4643-88a2-a4e388651568-csv",
  "scan_id": "32"
}

Export vulnerabilities

Get every finding (one vulnerability on one asset, with the plugin's details, CVEs and fix) matching the filters, through Tenable's export. Waits while Tenable prepares it. Without a date, Tenable covers the last 30 days.

Inputs

Severitiesseveritieslist
Only these severities. Leave empty for every severity.One or more of: critical, high, medium, low, info.
Statesstateslist
Only findings in these states. Defaults to open and reopened.One or more of: open, reopened (Reopened (resurfaced)), fixed.
First found afterfirst_found_afterdate and time
Only findings first found at or after this time.
Last seen afterlast_seen_afterdate and time
Only findings last seen at or after this time.
Fixed afterfixed_afterdate and time
Only findings fixed at or after this time (choose Fixed in States).
CVE IDscve_idslist
Only findings for these CVEs, such as CVE-2021-44228.
Plugin IDsplugin_idslist
Only findings from these plugins (Tenable's checks), by number.
Include plugin outputinclude_plugin_outputtrue/false
Include what each check printed, which can be long.
Most findingsmax_findingsnumber
Stop after this many findings, 1 to 10,000. Defaults to 1,000.From 1 to 10000.

Outputs

countnumber
How many are returned
export_uuidtext
Tenable's id for the export
findingslist
The findings
truncatedtrue/false
True when it stopped at Most findings with more left
Example output
{
  "count": 1,
  "export_uuid": "bf765455-53aa-4e70-9ef3-87cfca1d2be0",
  "findings": [
    {
      "asset": {
        "fqdn": "sharepoint2016.example.com",
        "hostname": "sharepoint2016",
        "ipv4": "203.0.113.71",
        "operating_system": [
          "Microsoft Windows Server 2016 Standard"
        ],
        "uuid": "53ed0fa2-ccd5-4d2e-92ee-c072635889e3"
      },
      "finding_id": "02716af9-1adb-4057-b4d5-dcb0c36b290c",
      "first_found": "2023-11-08T19:18:10.472Z",
      "last_fixed": "",
      "last_found": "2024-05-04T05:03:13.737Z",
      "output": "KB5002113 is missing.",
      "plugin": {
        "cve": [
          "CVE-2022-21837"
        ],
        "cvss3_base_score": 8.8,
        "description": "The SharePoint installation is missing security updates.",
        "exploit_available": false,
        "family": "Windows : Microsoft Bulletins",
        "has_patch": true,
        "id": 156641,
        "name": "Security Updates for Microsoft SharePoint Server 2016 (January 2022)",
        "solution": "Install security update KB5002113.",
        "synopsis": "The remote host is missing a security update."
      },
      "port": {
        "port": 445,
        "protocol": "TCP",
        "service": "cifs"
      },
      "scan": {
        "schedule_uuid": "461e4ebc-b309-face-6fa1-afa4ba163cb6d84b9dc0a0dc5020",
        "started_at": "2024-05-03T14:14:02.387Z",
        "uuid": "270b911b-1fe6-4760-8c49-88d315cb764e"
      },
      "severity": "high",
      "severity_id": 3,
      "state": "OPEN"
    }
  ],
  "truncated": false
}

Get asset

Get one asset with its addresses, host names, operating system, tags, sources and when it was first and last seen.

Inputs

Asset IDasset_idtextRequired
The asset's UUID, from 'List assets' or an earlier step.

Outputs

assetobject
The asset
Example output
{
  "asset": {
    "acr_score": 5,
    "created_at": "2026-04-18T10:31:22.214Z",
    "exposure_score": 686,
    "first_seen": "2026-04-18T10:31:22.000Z",
    "fqdn": [
      "web-01.example.com"
    ],
    "has_agent": true,
    "id": "236224b4-e3e7-4761-ad47-e32daaebec6b",
    "ipv4": [
      "192.0.2.80"
    ],
    "ipv6": [],
    "last_scan_target": "192.0.2.79",
    "last_seen": "2026-04-30T12:45:41.039Z",
    "mac_address": [
      "10:50:56:a6:90:fb"
    ],
    "name": "web-01",
    "netbios_name": [],
    "operating_system": [
      "Oracle Linux Server 8.7"
    ],
    "sources": [
      {
        "first_seen": "2026-04-18T11:48:03.328Z",
        "last_seen": "2026-04-30T12:45:41.039Z",
        "name": "NESSUS_AGENT"
      }
    ],
    "tags": [],
    "updated_at": "2026-07-02T00:53:32.864Z"
  }
}

Get plugin

Get a plugin (one of Tenable's vulnerability checks) with its family, synopsis, description, solution and risk factor.

Inputs

Plugin IDplugin_idnumberRequired
The plugin's number, such as 19506.At least 1.

Outputs

detailsobject
Its attributes by name, such as synopsis, description, solution and risk_factor
pluginobject
The plugin
Example output
{
  "details": {
    "risk_factor": "High"
  },
  "plugin": {
    "attributes": [
      {
        "attribute_name": "risk_factor",
        "attribute_value": "High"
      }
    ],
    "family_name": "AIX Local Security Checks",
    "id": 22372,
    "name": "AIX 5.1 : IY19744"
  }
}

Get scan results

Get a scan's latest run (or one past run): its status and times, each host with its count of findings by severity, and the findings grouped by plugin.

Inputs

Scanscan_idtextRequired
The scan. Pick one, or give its id or schedule UUID from an earlier step.
Run IDhistory_idnumber
One past run of the scan, its id from 'List scan runs'. Leave empty for the latest run.At least 1.

Outputs

historylist
The scan's runs
host_countnumber
How many hosts
hostslist
Each host scanned
infoobject
The scan and its run
vulnerabilitieslist
The findings, by plugin
vulnerability_countnumber
How many plugins found something
Example output
{
  "history": [
    {
      "creation_date": 1778088286,
      "history_id": 10328682,
      "last_modification_date": 1778089726,
      "status": "completed",
      "uuid": "fd7d0d8e-c0e1-4439-97a5-d5c3a5c2d369ab8f7ecb158c480e"
    }
  ],
  "host_count": 1,
  "hosts": [
    {
      "asset_id": 5,
      "critical": 0,
      "high": 3,
      "host_id": 5,
      "hostname": "192.0.2.57",
      "info": 156,
      "low": 1,
      "medium": 6,
      "score": 3766
    }
  ],
  "info": {
    "folder_id": 19,
    "hostcount": 1,
    "name": "Weekly servers",
    "owner": "jo@example.com",
    "scan_end": 1778089726,
    "scan_start": 1778088286,
    "scanner_name": "US Cloud Scanner",
    "schedule_uuid": "b0eeabbe-a612-429a-a60e-0f68eafb8c36f60557ee0e264228",
    "status": "completed",
    "targets": "192.0.2.57",
    "timestamp": 1778089726,
    "uuid": "fd7d0d8e-c0e1-4439-97a5-d5c3a5c2d369ab8f7ecb158c480e"
  },
  "vulnerabilities": [
    {
      "count": 68,
      "plugin_family": "Port scanners",
      "plugin_id": 34220,
      "plugin_name": "Netstat Portscanner (WMI)",
      "severity": 0
    }
  ],
  "vulnerability_count": 1
}

Launch scan

Start a scan now, optionally on other targets for this run only. Returns the new run's id; the scan runs on in Tenable.

Inputs

Scanscan_idtextRequired
The scan. Pick one, or give its id or schedule UUID from an earlier step.
Targets for this runalternate_targetslist
Scan these instead of the scan's own targets, this run only.

Outputs

scan_idtext
The scan's id
scan_uuidtext
The new run's UUID
Example output
{
  "scan_id": "32",
  "scan_uuid": "44346bcb-4afc-4db0-b283-2dd823fa8579"
}

List agents

List linked Tenable agents with their platform, IP address, status, health, groups and when they last connected.

Inputs

Searchsearchtext
Only agents with this text in their name, address or other details.
Page sizelimitnumber
How many to return, 1 to 5,000. Tenable's default is 50.From 1 to 5000.
Skipoffsetnumber
How many to skip, to get the next page.At least 0.

Outputs

agentslist
The agents
countnumber
How many are returned
totalnumber
How many Tenable has in all
Example output
{
  "agents": [
    {
      "asset_uuid": "bb1a9cf3-55a2-54ea-c88e-9a15000452f2",
      "core_version": "11.0.0",
      "distro": "win-x86-64",
      "groups": [
        {
          "id": 3316,
          "name": "Windows Agents"
        }
      ],
      "health_state_name": "HEALTHY",
      "id": 9176838,
      "ip": "192.0.2.57",
      "last_connect": 1768134873,
      "last_connected_at": "2026-01-11T12:34:33Z",
      "linked_at": "2025-02-28T19:50:43Z",
      "linked_on": 1740772243,
      "name": "LAPTOP-01",
      "network_name": "Default",
      "platform": "WINDOWS",
      "status": "on",
      "uuid": "655993d5-c131-46e8-a82f-957f6f894cac"
    }
  ],
  "count": 1,
  "total": 1
}

List assets

List or search assets (hosts and devices Tenable has seen) with their addresses, names, operating system and exposure score.

Inputs

Host name or address containssearchtext
Only assets whose host name or IP address contains this.
Operating system containsoperating_systemtext
Only assets whose operating system contains this, such as Windows.
Seen in the last (days)seen_within_daysnumber
Only what was seen in this many days, counting today.From 1 to 3650.
Most to returnlimitnumber
How many to return, 1 to 5,000. Defaults to 200.From 1 to 5000.

Outputs

assetslist
The assets
countnumber
How many are returned
totalnumber
How many matched
Example output
{
  "assets": [
    {
      "acr_score": 8,
      "exposure_score": 753,
      "first_seen": "2025-12-31T15:00:25.000Z",
      "fqdn": [
        "web-01.example.com"
      ],
      "has_agent": false,
      "id": "1d194ba1-d43a-4369-9d68-d2113a5d4da9",
      "ipv4": [
        "192.0.2.57"
      ],
      "ipv6": [],
      "last_scan_target": "192.0.2.57",
      "last_seen": "2025-12-31T17:28:28.000Z",
      "mac_address": [],
      "netbios_name": [
        "WEB-01"
      ],
      "operating_system": [
        "Microsoft Windows Server 2019"
      ],
      "sources": [
        {
          "first_seen": "2025-12-31T15:00:25.000Z",
          "last_seen": "2025-12-31T17:28:28.000Z",
          "name": "NESSUS_SCAN"
        }
      ]
    }
  ],
  "count": 1,
  "total": 1
}

List audit log events

List audit log events, newest first: who did what (sign-ins, changes to users, scans and settings), to what, and whether it failed.

Inputs

Afterafterdate and time
Only events after this time.
Beforebeforedate and time
Only events before this time.
Actionevent_actiontext
Only events of this action, such as user.create or session.create.
Most to returnlimitnumber
How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.

Outputs

countnumber
How many are returned
eventslist
The events, newest first
totalnumber
How many Tenable has in all
Example output
{
  "count": 1,
  "events": [
    {
      "action": "user.create",
      "actor": {
        "id": "b569d85a-2e80-44fa-9eb6-2693d656df41",
        "name": "jo@example.com"
      },
      "crud": "c",
      "description": "",
      "fields": [
        {
          "key": "X-Access-Type",
          "value": "apikey"
        }
      ],
      "id": "9ed34e87d3474ff985759d14a703e4c1",
      "is_failure": false,
      "received": "2025-12-31T23:33:01Z",
      "target": {
        "id": "da1499fd-afdb-4fb9-bfb6-9defec2f0f09",
        "name": "sam@example.com",
        "type": "User"
      }
    }
  ],
  "total": 1
}

List exclusions

List exclusions: the hosts, ranges and times scans must leave alone, with their schedules.

Inputs

Page sizelimitnumber
How many to return, 1 to 500. Tenable's default is 200.From 1 to 500.
Skipoffsetnumber
How many to skip, to get the next page.At least 0.

Outputs

countnumber
How many are returned
exclusionslist
The exclusions
totalnumber
How many Tenable has in all
Example output
{
  "count": 1,
  "exclusions": [
    {
      "creation_date": 1777493754,
      "description": "Weekly patch window.",
      "id": 1000106,
      "last_modification_date": 1777493754,
      "members": "db-01.example.com,192.0.2.1-192.0.2.255",
      "name": "Database maintenance",
      "network_id": "00000000-0000-0000-0000-000000000000",
      "schedule": {
        "enabled": true,
        "timezone": "America/New_York"
      },
      "uuid": "bb988de8-ab1f-4fd5-a5ea-6fcef8e49df6"
    }
  ],
  "total": 1
}

List scan runs

List a scan's past runs, newest first, with each run's status and when it started and finished.

Inputs

Scanscan_idtextRequired
The scan. Pick one, or give its id or schedule UUID from an earlier step.
Page sizelimitnumber
How many to return, 1 to 5,000. Tenable's default is 50.From 1 to 5000.
Skipoffsetnumber
How many to skip, to get the next page.At least 0.
Leave out rollover runsexclude_rollovertrue/false
Leave out runs Tenable started to finish targets an earlier run didn't reach.

Outputs

countnumber
How many are returned
historylist
The runs, newest first
totalnumber
How many Tenable has in all
Example output
{
  "count": 1,
  "history": [
    {
      "finished_at": "2025-12-27T21:17:37Z",
      "id": 10535505,
      "is_archived": false,
      "reporting_mode": "baseline",
      "scan_uuid": "9e3a89e5-f3d0-4708-9ec9-403a34e7cd5e",
      "started_at": "2025-12-27T21:15:21Z",
      "status": "completed",
      "time_end": 1766870257,
      "time_start": 1766870121
    }
  ],
  "total": 1
}

List scanners

List the scanners and scanner groups you can scan with, including Tenable's cloud scanners, with their status.

Inputs

None.

Outputs

countnumber
How many are returned
scannerslist
The scanners
Example output
{
  "count": 1,
  "scanners": [
    {
      "engine_version": "10.8.0",
      "group": true,
      "id": 351010,
      "last_connect": 1776026751,
      "name": "US Cloud Scanner",
      "network_name": "Default",
      "pool": true,
      "status": "on",
      "type": "local",
      "uuid": "00000000-0000-0000-0000-00000000000000000000000000001"
    }
  ]
}

List scans

List the scans you can see with their status (completed, running, aborted and so on) and when they last ran, optionally in one folder, by status, by name or by when they last started.

Inputs

Folderfolder_idtext
Only scans in this folder. Leave empty for every folder.
Statusstatustext
Only scans whose latest run has this status.One of: completed, running, pending, paused, aborted (Aborted (failed)), canceled, empty (Never run), imported.
Last started afterstarted_afterdate and time
Only scans whose latest run started at or after this time.
Name containsname_containstext
Only scans whose name contains this text.

Outputs

countnumber
How many are returned
scanslist
The scans
Example output
{
  "count": 1,
  "scans": [
    {
      "creation_date": 1762541180,
      "enabled": false,
      "folder_id": 19,
      "id": 32,
      "last_modification_date": 1762650112,
      "name": "Weekly servers",
      "owner": "jo@example.com",
      "progress": 100,
      "schedule_uuid": "26cf08d3-3f94-79f4-8038-996376eabd4f186741fe15533e70",
      "status": "completed",
      "template_uuid": "131a8e52-3ea6-a291-ec0a-d2ff0619c19d7bd788d6be818b65",
      "total_targets": 3,
      "type": "remote",
      "uuid": "c1d84965-c4c6-47ea-99c6-2111b803bcae"
    }
  ]
}

List tag categories

List the tag categories (such as Location or Owner) used to tag assets.

Inputs

Name containsname_containstext
Only categories whose name contains this.

Outputs

categorieslist
The categories
countnumber
How many are returned
Example output
{
  "categories": [
    {
      "created_at": "2025-12-31T16:10:21.412Z",
      "created_by": "jo@example.com",
      "description": "Where the asset is",
      "name": "Location",
      "reserved": false,
      "updated_at": "2025-12-31T15:39:16.540Z",
      "uuid": "e50a526c-966f-4b80-a641-6dd359b8202e"
    }
  ],
  "count": 1
}

List tags

List tags (each a category and value, such as Location: Seattle) with their UUIDs.

Inputs

Categorycategorytext
Only tags in this category. Leave empty for every category.
Value containsvalue_containstext
Only tags whose value contains this.

Outputs

countnumber
How many are returned
tagslist
The tags
Example output
{
  "count": 1,
  "tags": [
    {
      "category_description": "Where the asset is",
      "category_name": "Location",
      "category_uuid": "e50a526c-966f-4b80-a641-6dd359b8202e",
      "created_at": "2025-12-31T15:39:16.687Z",
      "created_by": "jo@example.com",
      "description": "Seattle office",
      "type": "static",
      "updated_at": "2025-12-31T15:39:16.687Z",
      "uuid": "76252c75-3f15-4258-82f5-6e5faed7f54a",
      "value": "Seattle"
    }
  ]
}

List users

List the account's users with their email, role level and whether they can sign in. Needs an administrator's API keys.

Inputs

None.

Outputs

countnumber
How many are returned
userslist
The users
Example output
{
  "count": 1,
  "users": [
    {
      "email": "jo@example.com",
      "enabled": true,
      "id": 2247978,
      "lastlogin": 1759474102779,
      "name": "Jo Bloggs",
      "permissions": 64,
      "type": "local",
      "username": "jo@example.com",
      "uuid": "0d67d2fa-558c-4f89-b506-41b4b73101e1"
    }
  ]
}

List vulnerabilities

List vulnerabilities grouped by plugin, with how many times each was found, across every asset or on one asset, optionally only some severities.

Inputs

Asset IDasset_idtext
Only this asset's vulnerabilities: its UUID. Leave empty for every asset.
Severitiesseveritieslist
Only these severities. Leave empty for every severity.One or more of: critical, high, medium, low, info.
Seen in the last (days)seen_within_daysnumber
Only what was seen in this many days, counting today.From 1 to 3650.
Most to returnlimitnumber
How many to return, 1 to 5,000. Defaults to 200.From 1 to 5000.

Outputs

countnumber
How many are returned
totalnumber
How many matched
total_asset_countnumber
How many assets they are on
total_vulnerability_countnumber
How many findings in all
vulnerabilitieslist
The vulnerabilities, by plugin
Example output
{
  "count": 1,
  "total": 1,
  "total_asset_count": 42,
  "total_vulnerability_count": 319,
  "vulnerabilities": [
    {
      "accepted_count": 0,
      "count": 319,
      "plugin_family": "General",
      "plugin_id": 51192,
      "plugin_name": "SSL Certificate Cannot Be Trusted",
      "recasted_count": 0,
      "severity": 2,
      "vpr_score": 2.4,
      "vulnerability_state": "Active"
    }
  ]
}

Pause scan

Pause a running scan. Tenable times out a scan paused for 14 days.

Inputs

Scanscan_idtextRequired
The scan. Pick one, or give its id or schedule UUID from an earlier step.

Outputs

requestedtrue/false
True once Tenable accepted it
scan_idtext
The scan's id
Example output
{
  "requested": true,
  "scan_id": "32"
}

Resume scan

Resume a paused scan from where it stopped.

Inputs

Scanscan_idtextRequired
The scan. Pick one, or give its id or schedule UUID from an earlier step.

Outputs

requestedtrue/false
True once Tenable accepted it
scan_idtext
The scan's id
Example output
{
  "requested": true,
  "scan_id": "32"
}

Stop scan

Stop a pending, running or paused scan. Its run ends as canceled.

Inputs

Scanscan_idtextRequired
The scan. Pick one, or give its id or schedule UUID from an earlier step.

Outputs

requestedtrue/false
True once Tenable accepted it
scan_idtext
The scan's id
Example output
{
  "requested": true,
  "scan_id": "32"
}

Tag assets

Add a tag to one or more assets, or take it off them. Tenable applies it in the background within a few minutes.

Inputs

Asset IDsasset_idslistRequired
The assets' UUIDs, from 'List assets' or an earlier step.
Tagtag_idtextRequired
The tag (a category and value pair). Pick one, or give its UUID.
Add or removetag_actiontext
Add the tag to the assets, or take it off them.One of: add (Add the tag), remove (Remove the tag). Default: add.

Outputs

asset_idslist
The assets changed
job_uuidtext
Tenable's id for the job
tag_actiontext
add or remove
tag_idtext
The tag
Example output
{
  "asset_ids": [
    "b03d603b-bfc4-4b23-9b8e-584c12551d07"
  ],
  "job_uuid": "62210d02a7056d0297f50a8ddfbd549eaef1d0bc94e1ea3fad09",
  "tag_action": "add",
  "tag_id": "76252c75-3f15-4258-82f5-6e5faed7f54a"
}

On this page