(Early Access) Vulnerability Management: Shared Collections

Documentation is now available for new endpoints added to the Tenable Vulnerability Management API to support shared collections. Shared collections enable users to quickly and conveniently share scan configurations with other Tenable Vulnerability Management users and groups. For more information about shared collections, see Shared Collections in the Tenable Vulnerability Management Early Access User Guide.

The new endpoints enable users to create, query, update, and delete shared collections, and to share and remove individual scan configurations from shared collections.

Endpoint	Name	Description
POST /shared-collections	Create shared collection	Creates a shared collection.
GET /shared-collections	List shared collections	Returns a list of shared collections that the current user has access to.
GET /shared-collections/{shared_collection_id}	Get shared collection details	Returns the details for the specified shared collection.
PUT /shared-collections/{shared_collection_id}	Update shared collection	Updates a shared collection. A shared collection can only be updated by the current owner or an administrator.
DELETE /shared-collections/{shared_collection_id}	Delete shared collection	Deletes a shared collection.
POST /shared-collections/_byName	Get shared collection details by name	Returns the details for the specified shared collection by name.
GET /shared-collections/request-status/{request_status_id}	Get job status	Retrieves the status of the specified asynchronous shared collections job. You can use the `request_status_id` returned in the response of the following endpoints to check the status of the asynchronous job: - Create shared collection - Update shared collection - Delete shared collection - Add scan configs to shared collection - Remove scan configs from shared collection
POST /shared-collections/{shared_collection_id}/scan-configs	Add scan configs to shared collection	Adds scan configurations to a shared collection.
GET /shared-collections/{shared_collection_id}/scan-configs	List scan configs in shared collection	Returns a list of scan configurations in a shared collection.
DELETE /shared-collections/{shared_collection_id}/scan-configs	Remove scan configs from shared collection	Removes scan configurations from a shared collection.