added
Web Application Scanning API v2 Available
over 5 years ago by Lance Duvall
Tenable.io Web Application Scanning API v2 is now available.
Tenable recommends that you use Tenable.io Web Application Scanning API v2 for any new development. You can continue to use existing integrations that are based on Tenable.io Web Application Scanning API v1. Tenable will provide advance notice and migration guidance prior to deprecating Tenable.io Web Application Scanning API v1. To keep up to date on product announcements, subscribe to our RSS feed or check the API Changelog.
For more information about Tenable.io Web Application Scanning, see the Tenable.io Web Application Scanning User Guide.
The following tables detail the new endpoints:
Attachments
| Category | Endpoint | Name |
|---|---|---|
| Attachments | GET /was/v2/attachments/{attachment_id} | Download attachment |
Configurations
| Category | Endpoint | Name |
|---|---|---|
| Configurations | POST /was/v2/configs | Create scan configuration |
| Configurations | POST /was/v2/configs/search | Search scan configurations |
| Configurations | GET /was/v2/configs/{config_id} | Get scan configuration details |
| Configurations | PUT /was/v2/configs/{config_id} | Upsert scan configuration |
| Configurations | PATCH /was/v2/configs/{config_id} | Move scan configuration |
| Configurations | DELETE /v2/configs/{config_id} | Delete scan configuration |
| Configurations | GET /was/v2/configs/{config_id}/status/{tracking_id} | Get scan configuration processing status |
Filters
| Category | Endpoint | Name |
|---|---|---|
| Filters | GET /was/v2/configs/filters | List scan configuration filters |
| Filters | GET /was/v2/configs/{config_id}/scans/filters | List scan filters |
| Filters | GET /was/v2/user-templates/filters | List user-defined template filters |
| Filters | GET /was/v2/vulnerabilities/filters | List vulnerability filters |
| Filters | GET /was/v2/scans/{scan_id}/vulnerabilities/filters | List vulnerability filters for scan |
Folders
| Category | Endpoint | Name |
|---|---|---|
| Folders | POST /was/v2/folders | Create folder |
| Folders | GET /was/v2/folders | List folders |
| Folders | PUT /was/v2/folders/{folder_id} | Rename folder |
| Folders | DELETE /was/v2/folders/{folder_id} | Delete folder |
Plugins
| Category | Endpoint | Name |
|---|---|---|
| Plugins | GET /was/v2/plugins | List plugins |
| Plugins | GET /was/v2/plugins/{plugin_id} | Get plugin details |
Scans
| Category | Endpoint | Name |
|---|---|---|
| Scans | POST /was/v2/configs/{config_id}/scans | Launch scan |
| Scans | POST /api/v3/was/import | Import scan |
| Scans | POST /was/v2/configs/{config_id}/scans/search | Search scans |
| Scans | GET /was/v2/scans/{scan_id} | Get scan details |
| Scans | PATCH /was/v2/scans/{scan_id} | Update scan status |
| Scans | DELETE /was/v2/scans/{scan_id} | Delete scan |
| Scans | GET /was/v2/scans/{scan_id}/notes | Get scan notes |
| Scans | POST /was/v2/scans/{scan_id}/vulnerabilities/search | Search vulnerabilities for scan |
| Scans | PUT /was/v2/scans/{scan_id}/report | Export scan results |
| Scans | GET /was/v2/scans/{scan_id}/report | Download exported scan |
| Scans | GET /api/v3/export/{scan_id} | Download debug ZIP file |
Templates
| Category | Endpoint | Name |
|---|---|---|
| Templates | GET /was/v2/templates | List Tenable-provided templates |
| Templates | GET /was/v2/templates/{template_id} | Get Tenable-provided template details |
| Templates | POST /was/v2/user-templates/search | Search user-defined templates |
| Templates | GET /was/v2/user-templates/{user_template_id} | Get user-defined template details |
| Templates | PUT /was/v2/user-templates/{user_template_id} | Update user-defined template |
| Templates | DELETE /was/v2/user-templates/{user_template_id} | Delete user-defined template |
Vulnerabilities
| Category | Endpoint | Name |
|---|---|---|
| Vulnerabilities | GET /was/v2/vulnerabilities/{vuln_id} | Get vulnerability details |
| Vulnerabilities | POST /was/v2/vulnerabilities/search | Search vulnerabilities |