Ability to delete completed scans via API / CLI

[Tsybon]

Currently, BBOT Server allows scans to be created, queried, and stopped — but there is no option to remove completed scans from the database.

When working with large-scale environments (hundreds/thousands of scans), storing historical data may be unnecessary or even harmful for database health. There should be a safe mechanism for removing old scan objects.

Desired functionality

Add API and CLI endpoints to:

• Delete a single scan by ID
• Purge multiple scans (e.g. by status FINISHED, older than X days, etc.)

Suggested syntax:

# CLI
bbctl scan delete <SCAN_ID>
bbctl scan delete --status FINISHED

# HTTP API
DELETE /v1/scans/{scan_uuid}

[TheTechromancer]

@Tsybon thanks for the feature request.

This is a planned feature, and one that will be added soon. It will need to be handled carefully, since deleting a scan will have a cascading effect. We do already have a mechanism for archiving old events (/events/archive).