Manage Scans

You can use the Tenable Vulnerability Management API to create, configure, and manage scans and agent scans.

For basic scan configuration information, see:

• Create a Scan
• Update a Scan
• Launch a Scan
• Scan Status
• View Scan Configuration Details
• Change Scan Ownership

For more advanced scan configuration information, see:

• Manage Tag-based Scans
• Manage Scan Routing
• Manage Remediation Scans

The following pages provide request body examples for various scan configuration and scan management scenarios.

• Discovery Scan: Launch on Demand
• Assessment Scan: Launch on Demand
• Assessment Scan: Shared
• Assessment Scan: Scan-Specific Credentials (Windows)
• Assessment Scan: Scan-specific Credentials (SSH)
• Assessment Scan: Managed Credentials (Windows)
• Assessment Scan: Policy-based
• Assessment Scan: Recurring
• Agent Scan: Recurring
• Remediation Scan: Multiple Assets and Plugins

📘

Note

To check the status of a scan, use the GET /scans/{scan_id}/latest-status endpoint, instead of the GET /scans/{scan_id} endpoint. Tenable recommends the GET /scans/{scan_id}/latest-status endpoint especially if you are programmatically checking the status of large numbers of scans.