Web Application Scanning: Scan Folders
Tenable.io Web Application Scanning now supports folders for scan jobs. This feature allows you to create custom folders for organizing your scans. Additionally, there are three Tenable-provided default folders: All Scans, My Scans, and Trash.
You are the only user who can view, rename, or delete the custom folders you create. You cannot share the custom folders you create with other users. For background information about scan folders, see Tenable.io Vulnerability Management User Guide.
You can use the Tenable.io Web Application Scanning v2 API to create, list, rename, and delete folders. The following endpoints are new:
| API Endpoint | Name | Description |
|---|---|---|
| POST /was/v2/folders | Create folder | Creates a new custom folder for the current user. |
| GET /was/v2/folders | List folders | Lists the current user's custom folders. |
| PUT /was/v2/folders/{folder_id} | Rename folder | Renames a folder for the current user. You cannot rename Tenable-provided scan folders or custom folders that belong to other users (even if your account has administrator privileges). |
| DELETE /was/v2/folders/{folder_id} | Delete folder | Deletes a folder. If you delete a folder that contains scans, Tenable.io Web Application Scanning automatically moves those scans to the Trash folder. You cannot delete Tenable-provided folders or custom folders that belong to other users (even if you use an administrator account). |
Additionally, there is a new Tenable.io Web Application Scanning v2 API endpoint that allows you to move a scan configuration to a specified folder:
| API Endpoint | Name | Description |
|---|---|---|
| PATCH /was/v2/configs/{config_id} | Move scan configuration | Moves the scan configuration to the specified folder. |