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
| Action | What it does |
|---|---|
| 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. |
| Create tag | Create a tag value in a category, such as Seattle in Location. |
| Delete scan | Delete a scan and its results. |
| Delete tag | Delete a tag value, which also takes it off every asset. |
| Export scan results | Export a scan's results as a file (CSV, Nessus, HTML or PDF) a later step can attach or upload. |
| 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. |
| Get asset | Get one asset with its addresses, host names, operating system, tags, sources and when it was first and last seen. |
| Get plugin | Get a plugin (one of Tenable's vulnerability checks) with its family, synopsis, description, solution and risk factor. |
| 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. |
| Launch scan | Start a scan now, optionally on other targets for this run only. |
| List agents | List linked Tenable agents with their platform, IP address, status, health, groups and when they last connected. |
| List assets | List or search assets (hosts and devices Tenable has seen) with their addresses, names, operating system and exposure score. |
| 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. |
| List exclusions | List exclusions: the hosts, ranges and times scans must leave alone, with their schedules. |
| List scan runs | List a scan's past runs, newest first, with each run's status and when it started and finished. |
| List scanners | List the scanners and scanner groups you can scan with, including Tenable's cloud scanners, with their status. |
| 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. |
| List tag categories | List the tag categories (such as Location or Owner) used to tag assets. |
| List tags | List tags (each a category and value, such as Location: Seattle) with their UUIDs. |
| List users | List the account's users with their email, role level and whether they can sign in. |
| 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. |
| Pause scan | Pause a running scan. |
| Resume scan | Resume a paused scan from where it stopped. |
| Stop scan | Stop a pending, running or paused scan. |
| Tag assets | Add 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
- Name
nametextRequired - The scan's name.
- Targets
targetslistRequired - What to scan: IP addresses, ranges (192.0.2.1-192.0.2.20), CIDR blocks or host names.
- Template
templatetext - The scan template. Pick one, or type its name such as basic. Defaults to Basic Network Scan.
- Scanner
scanner_idtext - The scanner to use. Defaults to Tenable's cloud scanner.
- Folder
folder_idtext - The folder to keep the scan in. Defaults to My Scans.
- Description
descriptiontext - A description of the scan.
- Email when finished
emailslist - 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
- Category
categorytextRequired - The category. Pick one, or type a new one.
- Value
valuetextRequired - The tag's value, up to 50 characters, with no commas.
- Description
descriptiontext - 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
- Scan
scan_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
- Tag
tag_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
- Scan
scan_idtextRequired - The scan. Pick one, or give its id or schedule UUID from an earlier step.
- Format
file_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 ID
history_idnumber - One past run of the scan, its id from 'List scan runs'. Leave empty for the latest run.At least 1.
- Report sections
chapterslist - 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
- Severities
severitieslist - Only these severities. Leave empty for every severity.One or more of:
critical,high,medium,low,info. - States
stateslist - Only findings in these states. Defaults to open and reopened.One or more of:
open,reopened(Reopened (resurfaced)),fixed. - First found after
first_found_afterdate and time - Only findings first found at or after this time.
- Last seen after
last_seen_afterdate and time - Only findings last seen at or after this time.
- Fixed after
fixed_afterdate and time - Only findings fixed at or after this time (choose Fixed in States).
- CVE IDs
cve_idslist - Only findings for these CVEs, such as CVE-2021-44228.
- Plugin IDs
plugin_idslist - Only findings from these plugins (Tenable's checks), by number.
- Include plugin output
include_plugin_outputtrue/false - Include what each check printed, which can be long.
- Most findings
max_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 ID
asset_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 ID
plugin_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
- Scan
scan_idtextRequired - The scan. Pick one, or give its id or schedule UUID from an earlier step.
- Run ID
history_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
- Scan
scan_idtextRequired - The scan. Pick one, or give its id or schedule UUID from an earlier step.
- Targets for this run
alternate_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
- Search
searchtext - Only agents with this text in their name, address or other details.
- Page size
limitnumber - How many to return, 1 to 5,000. Tenable's default is 50.From 1 to 5000.
- Skip
offsetnumber - 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 contains
searchtext - Only assets whose host name or IP address contains this.
- Operating system contains
operating_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 return
limitnumber - 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
- After
afterdate and time - Only events after this time.
- Before
beforedate and time - Only events before this time.
- Action
event_actiontext - Only events of this action, such as user.create or session.create.
- Most to return
limitnumber - 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 size
limitnumber - How many to return, 1 to 500. Tenable's default is 200.From 1 to 500.
- Skip
offsetnumber - 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
- Scan
scan_idtextRequired - The scan. Pick one, or give its id or schedule UUID from an earlier step.
- Page size
limitnumber - How many to return, 1 to 5,000. Tenable's default is 50.From 1 to 5000.
- Skip
offsetnumber - How many to skip, to get the next page.At least 0.
- Leave out rollover runs
exclude_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
- Folder
folder_idtext - Only scans in this folder. Leave empty for every folder.
- Status
statustext - Only scans whose latest run has this status.One of:
completed,running,pending,paused,aborted(Aborted (failed)),canceled,empty(Never run),imported. - Last started after
started_afterdate and time - Only scans whose latest run started at or after this time.
- Name contains
name_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 contains
name_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
- Category
categorytext - Only tags in this category. Leave empty for every category.
- Value contains
value_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 ID
asset_idtext - Only this asset's vulnerabilities: its UUID. Leave empty for every asset.
- Severities
severitieslist - 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 return
limitnumber - 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
- Scan
scan_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
- Scan
scan_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
- Scan
scan_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 IDs
asset_idslistRequired - The assets' UUIDs, from 'List assets' or an earlier step.
- Tag
tag_idtextRequired - The tag (a category and value pair). Pick one, or give its UUID.
- Add or remove
tag_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"
}