Tenable removed the documentation for several of the v3 beta endpoints on February 22nd, 2023. The v3 beta endpoints were sometimes referred to collectively as the explore workbench API. Tenable recommends that customers discontinue their use of the beta endpoints for production and integration purposes. Refer to the Alternative Endpoints section for alternatives.
The v3 beta endpoints that were removed from the developer portal are described in the following tables:
| Name | Endpoint |
|---|
| Search assets | POST /api/v3/assets/search |
| Name | Endpoint |
|---|
| Search vulnerability findings | POST /api/v3/findings/vulnerabilities/host/search |
| Name | Endpoint |
|---|
| Create export | POST /api/v3/exports/jobs |
| Search export jobs | POST /api/v3/exports/jobs/search |
| Get export details | GET /api/v3/exports/jobs/{id} |
| Delete export job | DELETE /api/v3/exports/jobs/{id} |
| Download export | GET /api/v3/exports/jobs/{id}/content |
| Renew export job | PUT /api/v3/exports/jobs/{id}/renew |
| Name | Endpoint |
|---|
| Create scheduled export | POST /api/v3/exports/jobs/schedules |
| List scheduled exports | GET /api/v3/exports/jobs/schedules |
| Get scheduled export details | GET /api/v3/exports/jobs/schedules/{schedule_id} |
| Update scheduled export | PUT /api/v3/exports/jobs/schedules/{schedule_id} |
| Delete scheduled export | DELETE /api/v3/exports/jobs/schedules/{schedule_id} |
| Get scheduled export count | GET /api/v3/exports/jobs/schedules/count |
| Download scheduled export | GET /api/v3/exports/jobs/schedules/{schedule_id}/content |
| Cancel scheduled export | PUT /api/v3/exports/jobs/schedules/{schedule_id}/cancel |
| Name | Endpoint |
|---|
| Get search job details | GET /api/v3/search_jobs/{search_job_id} |
Customer access to the v3 beta endpoints will eventually be removed but a date has yet to be determined. Access to the v3 beta endpoints will not cease immediately; however, customers should prepare for access to these APIs to be removed within the year. Tenable recommends that customers use the export endpoints described in the following tables instead. Please update any existing integrations that your organization has.
