Tenable Workbenches API
The Workbenches API from Tenable — 14 operation(s) for workbenches.
Operations 14
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“What vulnerabilities have been recorded across my environment?”
“Is there a cap on how many vulnerabilities the workbench list returns?”
Tell an agent
List vulnerabilities seen in the last {date_range} days.
List workbench vulnerabilities where {filter} {quality} {value}.
GET
/workbenches/vulnerabilities/{plugin_id}/info
Get workbench details for a plugin · Get plugin details
#
Ask an LLM
“What does the workbench know about a specific vulnerability plugin across my assets?”
“Can I see a plugin's description, solution and risk info from the workbench?”
Tell an agent
Get workbench details for plugin {plugin_id}.
Show info for plugin {plugin_id} over the last {date_range} days.
GET
/workbenches/vulnerabilities/{plugin_id}/outputs
List plugin outputs across assets · List plugin outputs
#
Ask an LLM
“Where can I see the raw plugin output a vulnerability check produced on my hosts?”
“Which assets reported output for a given plugin?”
Tell an agent
List the outputs for plugin {plugin_id} across all assets.
Get plugin {plugin_id} output from the last {date_range} days.
Ask an LLM
“Which assets does my vulnerability management workbench know about?”
“Can I return every field for each asset in the workbench list?”
Tell an agent
List workbench assets seen in the last {date_range} days.
List assets with all fields set to {all_fields}.
GET
/workbenches/assets/vulnerabilities
List assets that have vulnerabilities · List assets with vulnerabilities
#
Ask an LLM
“Which of my assets currently have vulnerabilities and how many?”
“Can I filter the list of vulnerable assets by severity?”
Tell an agent
List assets that have vulnerabilities.
Show vulnerable assets where {filter} {quality} {value}.
Ask an LLM
“What does Tenable know about a specific asset, like its IPs and operating system?”
“Can I get every available field for a single asset?”
Tell an agent
Get information about asset {asset_id}.
Show all fields for asset {asset_id} with all_fields {all_fields}.
GET
/workbenches/assets/{asset_uuid}/activity
Get an asset's activity log · Get asset activity log
#
Ask an LLM
“When was an asset discovered, last seen or tagged?”
“Is there a history of changes for one of my assets?”
Tell an agent
Show the activity log for asset {asset_uuid}.
Get discovery and tagging events for asset {asset_uuid}.
GET
/workbenches/assets/{asset_id}/vulnerabilities
List vulnerabilities on an asset · List asset vulnerabilities
#
Ask an LLM
“What vulnerabilities are recorded on a particular host?”
“Are an asset's vulnerabilities sorted by count by default?”
Tell an agent
List vulnerabilities on asset {asset_id}.
Show asset {asset_id} vulnerabilities from the last {date_range} days.
GET
/workbenches/assets/{asset_id}/vulnerabilities/{plugin_id}/info
Get a vulnerability's details on one asset · Get asset vulnerability details
#
Ask an LLM
“How do I see the details of one specific vulnerability on one specific host?”
“Can I check when a plugin finding was first and last seen on an asset?”
Tell an agent
Get details of plugin {plugin_id} on asset {asset_id}.
Show vulnerability info for plugin {plugin_id} recorded on host {asset_id}.
GET
/workbenches/assets/{asset_id}/vulnerabilities/{plugin_id}/outputs
Get plugin output for a vulnerability on an asset · List asset vulnerabilities for plugin
#
Ask an LLM
“What raw output did a plugin produce on one particular asset?”
“Can I see the port and evidence a check reported on a single host?”
Tell an agent
Get plugin {plugin_id} output on asset {asset_id}.
Show what plugin {plugin_id} reported for host {asset_id} in the last {date_range} days.
Ask an LLM
“How do I delete an asset and its vulnerability data?”
“Does deleting an asset immediately reduce my licensed asset count?”
Tell an agent destructive · confirm first
Delete asset {asset_uuid}.
Remove host {asset_uuid} and its vulnerability history.
Ask an LLM
“Can I export the vulnerabilities workbench to a PDF or CSV report?”
“Which chapters can I include when exporting a workbench?”
Tell an agent
Export the {report} workbench as {format} with chapters {chapter}.
Export the {report} workbench for asset {asset_id} as {format} including {chapter}.
Ask an LLM
“Is my workbench export file ready to download yet?”
“What status do I poll for before downloading a workbench export?”
Tell an agent
Check the status of workbench export {file_id}.
Tell me whether workbench export {file_id} is ready to download.
GET
/workbenches/export/{file_id}/download
Download a workbench export file · Download export file
#
Ask an LLM
“How do I download a workbench export once it says ready?”
“Is the workbench export download endpoint deprecated?”
Tell an agent
Download workbench export file {file_id}.
Save the finished workbench export {file_id}.