# Tenable Vulnerability Management

> 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.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/tenable

## Actions

### 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 (`name`, text, required): The scan's name.
- Targets (`targets`, list, required): What to scan: IP addresses, ranges (192.0.2.1-192.0.2.20), CIDR blocks or host names.
- Template (`template`, text): The scan template. Pick one, or type its name such as basic. Defaults to Basic Network Scan.
- Scanner (`scanner_id`, text): The scanner to use. Defaults to Tenable's cloud scanner.
- Folder (`folder_id`, text): The folder to keep the scan in. Defaults to My Scans.
- Description (`description`, text): A description of the scan.
- Email when finished (`emails`, list): Addresses Tenable emails when a run finishes.

**Outputs**

- `scan` (object): The new scan

**Example output**

```json
{
  "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 (`category`, text, required): The category. Pick one, or type a new one.
- Value (`value`, text, required): The tag's value, up to 50 characters, with no commas.
- Description (`description`, text): What the tag means.

**Outputs**

- `tag` (object): The new tag

**Example output**

```json
{
  "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_id`, text, required): The scan. Pick one, or give its id or schedule UUID from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `scan_id` (text): The scan's id

**Example output**

```json
{
  "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_id`, text, required): The tag (a category and value pair). Pick one, or give its UUID.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `tag_id` (text): The tag deleted

**Example output**

```json
{
  "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_id`, text, required): The scan. Pick one, or give its id or schedule UUID from an earlier step.
- Format (`file_format`, text): 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_id`, number): One past run of the scan, its id from 'List scan runs'. Leave empty for the latest run. At least 1.
- Report sections (`chapters`, list): 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**

- `file` (object): The saved file
- `file_format` (text): csv, nessus, html or pdf
- `file_id` (text): Tenable's id for the export
- `scan_id` (text): The scan's id

**Example output**

```json
{
  "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 (`severities`, list): Only these severities. Leave empty for every severity. One or more of: `critical`, `high`, `medium`, `low`, `info`.
- States (`states`, list): Only findings in these states. Defaults to open and reopened. One or more of: `open`, `reopened` (Reopened (resurfaced)), `fixed`.
- First found after (`first_found_after`, date and time): Only findings first found at or after this time.
- Last seen after (`last_seen_after`, date and time): Only findings last seen at or after this time.
- Fixed after (`fixed_after`, date and time): Only findings fixed at or after this time (choose Fixed in States).
- CVE IDs (`cve_ids`, list): Only findings for these CVEs, such as CVE-2021-44228.
- Plugin IDs (`plugin_ids`, list): Only findings from these plugins (Tenable's checks), by number.
- Include plugin output (`include_plugin_output`, true/false): Include what each check printed, which can be long.
- Most findings (`max_findings`, number): Stop after this many findings, 1 to 10,000. Defaults to 1,000. From 1 to 10000.

**Outputs**

- `count` (number): How many are returned
- `export_uuid` (text): Tenable's id for the export
- `findings` (list): The findings
- `truncated` (true/false): True when it stopped at Most findings with more left

**Example output**

```json
{
  "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_id`, text, required): The asset's UUID, from 'List assets' or an earlier step.

**Outputs**

- `asset` (object): The asset

**Example output**

```json
{
  "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_id`, number, required): The plugin's number, such as 19506. At least 1.

**Outputs**

- `details` (object): Its attributes by name, such as synopsis, description, solution and risk_factor
- `plugin` (object): The plugin

**Example output**

```json
{
  "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_id`, text, required): The scan. Pick one, or give its id or schedule UUID from an earlier step.
- Run ID (`history_id`, number): One past run of the scan, its id from 'List scan runs'. Leave empty for the latest run. At least 1.

**Outputs**

- `history` (list): The scan's runs
- `host_count` (number): How many hosts
- `hosts` (list): Each host scanned
- `info` (object): The scan and its run
- `vulnerabilities` (list): The findings, by plugin
- `vulnerability_count` (number): How many plugins found something

**Example output**

```json
{
  "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_id`, text, required): The scan. Pick one, or give its id or schedule UUID from an earlier step.
- Targets for this run (`alternate_targets`, list): Scan these instead of the scan's own targets, this run only.

**Outputs**

- `scan_id` (text): The scan's id
- `scan_uuid` (text): The new run's UUID

**Example output**

```json
{
  "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 (`search`, text): Only agents with this text in their name, address or other details.
- Page size (`limit`, number): How many to return, 1 to 5,000. Tenable's default is 50. From 1 to 5000.
- Skip (`offset`, number): How many to skip, to get the next page. At least 0.

**Outputs**

- `agents` (list): The agents
- `count` (number): How many are returned
- `total` (number): How many Tenable has in all

**Example output**

```json
{
  "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 (`search`, text): Only assets whose host name or IP address contains this.
- Operating system contains (`operating_system`, text): Only assets whose operating system contains this, such as Windows.
- Seen in the last (days) (`seen_within_days`, number): Only what was seen in this many days, counting today. From 1 to 3650.
- Most to return (`limit`, number): How many to return, 1 to 5,000. Defaults to 200. From 1 to 5000.

**Outputs**

- `assets` (list): The assets
- `count` (number): How many are returned
- `total` (number): How many matched

**Example output**

```json
{
  "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 (`after`, date and time): Only events after this time.
- Before (`before`, date and time): Only events before this time.
- Action (`event_action`, text): Only events of this action, such as user.create or session.create.
- Most to return (`limit`, number): How many to return, 1 to 1,000. Defaults to 50. From 1 to 1000.

**Outputs**

- `count` (number): How many are returned
- `events` (list): The events, newest first
- `total` (number): How many Tenable has in all

**Example output**

```json
{
  "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 (`limit`, number): How many to return, 1 to 500. Tenable's default is 200. From 1 to 500.
- Skip (`offset`, number): How many to skip, to get the next page. At least 0.

**Outputs**

- `count` (number): How many are returned
- `exclusions` (list): The exclusions
- `total` (number): How many Tenable has in all

**Example output**

```json
{
  "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_id`, text, required): The scan. Pick one, or give its id or schedule UUID from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 5,000. Tenable's default is 50. From 1 to 5000.
- Skip (`offset`, number): How many to skip, to get the next page. At least 0.
- Leave out rollover runs (`exclude_rollover`, true/false): Leave out runs Tenable started to finish targets an earlier run didn't reach.

**Outputs**

- `count` (number): How many are returned
- `history` (list): The runs, newest first
- `total` (number): How many Tenable has in all

**Example output**

```json
{
  "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**

- `count` (number): How many are returned
- `scanners` (list): The scanners

**Example output**

```json
{
  "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_id`, text): Only scans in this folder. Leave empty for every folder.
- Status (`status`, text): 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_after`, date and time): Only scans whose latest run started at or after this time.
- Name contains (`name_contains`, text): Only scans whose name contains this text.

**Outputs**

- `count` (number): How many are returned
- `scans` (list): The scans

**Example output**

```json
{
  "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_contains`, text): Only categories whose name contains this.

**Outputs**

- `categories` (list): The categories
- `count` (number): How many are returned

**Example output**

```json
{
  "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 (`category`, text): Only tags in this category. Leave empty for every category.
- Value contains (`value_contains`, text): Only tags whose value contains this.

**Outputs**

- `count` (number): How many are returned
- `tags` (list): The tags

**Example output**

```json
{
  "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**

- `count` (number): How many are returned
- `users` (list): The users

**Example output**

```json
{
  "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_id`, text): Only this asset's vulnerabilities: its UUID. Leave empty for every asset.
- Severities (`severities`, list): Only these severities. Leave empty for every severity. One or more of: `critical`, `high`, `medium`, `low`, `info`.
- Seen in the last (days) (`seen_within_days`, number): Only what was seen in this many days, counting today. From 1 to 3650.
- Most to return (`limit`, number): How many to return, 1 to 5,000. Defaults to 200. From 1 to 5000.

**Outputs**

- `count` (number): How many are returned
- `total` (number): How many matched
- `total_asset_count` (number): How many assets they are on
- `total_vulnerability_count` (number): How many findings in all
- `vulnerabilities` (list): The vulnerabilities, by plugin

**Example output**

```json
{
  "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_id`, text, required): The scan. Pick one, or give its id or schedule UUID from an earlier step.

**Outputs**

- `requested` (true/false): True once Tenable accepted it
- `scan_id` (text): The scan's id

**Example output**

```json
{
  "requested": true,
  "scan_id": "32"
}
```

### Resume scan

Resume a paused scan from where it stopped.

**Inputs**

- Scan (`scan_id`, text, required): The scan. Pick one, or give its id or schedule UUID from an earlier step.

**Outputs**

- `requested` (true/false): True once Tenable accepted it
- `scan_id` (text): The scan's id

**Example output**

```json
{
  "requested": true,
  "scan_id": "32"
}
```

### Stop scan

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

**Inputs**

- Scan (`scan_id`, text, required): The scan. Pick one, or give its id or schedule UUID from an earlier step.

**Outputs**

- `requested` (true/false): True once Tenable accepted it
- `scan_id` (text): The scan's id

**Example output**

```json
{
  "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_ids`, list, required): The assets' UUIDs, from 'List assets' or an earlier step.
- Tag (`tag_id`, text, required): The tag (a category and value pair). Pick one, or give its UUID.
- Add or remove (`tag_action`, text): 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_ids` (list): The assets changed
- `job_uuid` (text): Tenable's id for the job
- `tag_action` (text): add or remove
- `tag_id` (text): The tag

**Example output**

```json
{
  "asset_ids": [
    "b03d603b-bfc4-4b23-9b8e-584c12551d07"
  ],
  "job_uuid": "62210d02a7056d0297f50a8ddfbd549eaef1d0bc94e1ea3fad09",
  "tag_action": "add",
  "tag_id": "76252c75-3f15-4258-82f5-6e5faed7f54a"
}
```
